{"_id":"@ahofmcpserver/apple-notes-mcp","_rev":"5-b1fb432c2338d7fe9c77706b4653f686","name":"@ahofmcpserver/apple-notes-mcp","dist-tags":{"latest":"1.0.4"},"versions":{"1.0.0":{"name":"@ahofmcpserver/apple-notes-mcp","version":"1.0.0","keywords":["mcp","apple-notes","notes","macos","claude"],"license":"MIT","_id":"@ahofmcpserver/apple-notes-mcp@1.0.0","maintainers":[{"name":"ahofmcpserver","email":"andreshofmann@gmail.com"}],"os":["darwin"],"bin":{"apple-notes-mcp":"bin/apple-notes-mcp.js"},"dist":{"shasum":"6d0a5fda52cc177acece3e628714bcf3bc7b7afe","tarball":"https://registry.npmjs.org/@ahofmcpserver/apple-notes-mcp/-/apple-notes-mcp-1.0.0.tgz","fileCount":4,"integrity":"sha512-M7yviwQtN1ZVmz2B8GIJw2Ip49gcSaKp44q0WNaUpXtnEncNH4So/REIzWAL3bGHPHiYw2zTM4GpSRVLu1pQkA==","signatures":[{"sig":"MEUCIDbM7gjqF7GXGvSxWBMD4V8uKrY/P4h5OjLhNqlk3DuOAiEAqTQSeK2Y1KgZma78reDYmtRqndV+ouZlt99gW9CNTaI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":103866},"claude":{"icon":"๐Ÿ“","type":"mcp","description":"Full CRUD on Apple Notes โ€” notes, folders, attachments, backup/restore. 44 tools.","displayName":"Apple Notes"},"engines":{"node":">=18"},"_npmUser":{"name":"ahofmcpserver","email":"andreshofmann@gmail.com"},"_npmVersion":"11.9.0","description":"Full Apple Notes MCP server โ€” create, edit, search, manage folders and attachments, backup and restore.","directories":{},"_nodeVersion":"25.6.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/apple-notes-mcp_1.0.0_1778561578914_0.12173025137499316","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@ahofmcpserver/apple-notes-mcp","version":"1.0.1","keywords":["mcp","apple-notes","notes","macos","claude"],"license":"MIT","_id":"@ahofmcpserver/apple-notes-mcp@1.0.1","maintainers":[{"name":"ahofmcpserver","email":"andreshofmann@gmail.com"}],"os":["darwin"],"bin":{"apple-notes-mcp":"bin/apple-notes-mcp.js"},"dist":{"shasum":"3d969a758ce6320a32730f18d6b2e36d41d38214","tarball":"https://registry.npmjs.org/@ahofmcpserver/apple-notes-mcp/-/apple-notes-mcp-1.0.1.tgz","fileCount":4,"integrity":"sha512-JZ/kGMkCbjtsk3Bhh+qFOwc6hGdcnGKfSJqlwryTzkZ9N4J/Qinr2JT8+T/JAF4xtE8WiaukK7KF5IGgvhfzlw==","signatures":[{"sig":"MEYCIQDgJ852oyobmehnh3+K475tNFqTjX3ku8CymReFwT9J7wIhAJAA9eBNH/wHZEvZb1wQ3JUS2NAfLGCQIz9YBoPmX7sb","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":104307},"claude":{"icon":"๐Ÿ“","type":"mcp","description":"Full CRUD on Apple Notes โ€” notes, folders, attachments, backup/restore. 44 tools.","displayName":"Apple Notes"},"engines":{"node":">=18"},"_npmUser":{"name":"ahofmcpserver","email":"andreshofmann@gmail.com"},"_npmVersion":"11.9.0","description":"Full Apple Notes MCP server โ€” create, edit, search, manage folders and attachments, backup and restore.","directories":{},"_nodeVersion":"25.6.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/apple-notes-mcp_1.0.1_1778602410873_0.7829560378867095","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@ahofmcpserver/apple-notes-mcp","version":"1.0.2","keywords":["mcp","apple-notes","notes","macos","claude"],"license":"MIT","_id":"@ahofmcpserver/apple-notes-mcp@1.0.2","maintainers":[{"name":"ahofmcpserver","email":"andreshofmann@gmail.com"}],"os":["darwin"],"bin":{"apple-notes-mcp":"bin/apple-notes-mcp.js"},"dist":{"shasum":"0f2d773fb38d3042ce73f1c4b7dbb92b21f399ce","tarball":"https://registry.npmjs.org/@ahofmcpserver/apple-notes-mcp/-/apple-notes-mcp-1.0.2.tgz","fileCount":4,"integrity":"sha512-9MYRYvIpeYqBc5ttpYuvjAo6QF6zj9p6h/CEiZ37H2BUSI+uZP/IHbQbXxVVVFUrBhxQZev/MzZRas3B2SGfrg==","signatures":[{"sig":"MEUCIQD6QzHvZGYTDfVig/xqAYHw7TqkBmWBonfvEPEnvhVpUQIgF4z94FHWAIi+i9yfGHZTZlJvSzwn8kPahv8sz17KxUI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":105188},"claude":{"icon":"๐Ÿ“","type":"mcp","description":"Full CRUD on Apple Notes โ€” notes, folders, attachments, backup/restore. 44 tools.","displayName":"Apple Notes"},"engines":{"node":">=18"},"_npmUser":{"name":"ahofmcpserver","email":"andreshofmann@gmail.com"},"_npmVersion":"11.9.0","description":"Full Apple Notes MCP server โ€” create, edit, search, manage folders and attachments, backup and restore.","directories":{},"_nodeVersion":"25.6.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/apple-notes-mcp_1.0.2_1778793433529_0.23012449212106523","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@ahofmcpserver/apple-notes-mcp","version":"1.0.3","keywords":["mcp","apple-notes","notes","macos","claude"],"license":"MIT","_id":"@ahofmcpserver/apple-notes-mcp@1.0.3","maintainers":[{"name":"ahofmcpserver","email":"andreshofmann@gmail.com"}],"os":["darwin"],"bin":{"apple-notes-mcp":"bin/apple-notes-mcp.js"},"dist":{"shasum":"6479dc4743bbb198d8ed1a997aa95bed5e4db2b1","tarball":"https://registry.npmjs.org/@ahofmcpserver/apple-notes-mcp/-/apple-notes-mcp-1.0.3.tgz","fileCount":4,"integrity":"sha512-fMt0grdSqdDX+7F6AO+rcwQbFMIrDECbZHSvBDt90A1hXbAFS8X4uxbBLmwvqY5fnFnkHsO++xZl5nM/kkWYAQ==","signatures":[{"sig":"MEQCIBNWNH+10MjxHYXUoASmD2cV6NqQxn74Umyp4WjD2Gv6AiAVyIvH1xmhl1tcohLOkEHey/8y5wYqYflqIZ8KpYhfbg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":116035},"claude":{"icon":"๐Ÿ“","type":"mcp","description":"Full CRUD on Apple Notes โ€” notes, folders, attachments, backup/restore, full-fidelity vault import. 45 tools.","displayName":"Apple Notes"},"engines":{"node":">=18"},"_npmUser":{"name":"ahofmcpserver","email":"andreshofmann@gmail.com"},"_npmVersion":"11.9.0","description":"Full Apple Notes MCP server โ€” create, edit, search, manage folders and attachments, backup and restore, full-fidelity vault import.","directories":{},"_nodeVersion":"25.6.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/apple-notes-mcp_1.0.3_1778801702487_0.9147753392146631","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@ahofmcpserver/apple-notes-mcp","version":"1.0.4","description":"Full Apple Notes MCP server โ€” create, edit, search, manage folders and attachments, backup and restore, full-fidelity vault import.","keywords":["mcp","apple-notes","notes","macos","claude"],"license":"MIT","os":["darwin"],"engines":{"node":">=18"},"bin":{"apple-notes-mcp":"bin/apple-notes-mcp.js"},"claude":{"type":"mcp","displayName":"Apple Notes","description":"Full CRUD on Apple Notes โ€” notes, folders, attachments, backup/restore, vault import, share management. 47 tools.","icon":"๐Ÿ“"},"_id":"@ahofmcpserver/apple-notes-mcp@1.0.4","_nodeVersion":"25.6.1","_npmVersion":"11.9.0","dist":{"integrity":"sha512-B97VdwVlYLGPIm85N8OAvHxc99DpmeUxHTW4icps+PYifCp3Iw8YYbhY89VggklPxCZ5Jud7Vm4QxbqkGGytFw==","shasum":"419e13da084ad90b41642a5200494217f94a3e67","tarball":"https://registry.npmjs.org/@ahofmcpserver/apple-notes-mcp/-/apple-notes-mcp-1.0.4.tgz","fileCount":4,"unpackedSize":120744,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICJNVl8nIDBMFQD2vLLQsOP/hyepxM6dU8SIDYhtsrX5AiBnb6+F7e8nYrvgH3pmCaS7qvYpagjBwI3er4OSrOoyGQ=="}]},"_npmUser":{"name":"ahofmcpserver","email":"andreshofmann@gmail.com"},"directories":{},"maintainers":[{"name":"ahofmcpserver","email":"andreshofmann@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/apple-notes-mcp_1.0.4_1778813112410_0.1549204344982822"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-12T04:52:58.840Z","modified":"2026-05-15T02:45:12.722Z","1.0.0":"2026-05-12T04:52:59.070Z","1.0.1":"2026-05-12T16:13:31.092Z","1.0.2":"2026-05-14T21:17:13.691Z","1.0.3":"2026-05-14T23:35:02.633Z","1.0.4":"2026-05-15T02:45:12.585Z"},"license":"MIT","keywords":["mcp","apple-notes","notes","macos","claude"],"description":"Full Apple Notes MCP server โ€” create, edit, search, manage folders and attachments, backup and restore, full-fidelity vault import.","maintainers":[{"name":"ahofmcpserver","email":"andreshofmann@gmail.com"}],"readme":"# apple-notes-mcp\n\nFull Apple Notes MCP server for Claude Code. 44 tools covering every Notes operation.\n\n## Requirements\n\n- macOS (uses Apple Notes and NoteStore.sqlite)\n- Python 3.9+ (`brew install python3`)\n- Claude Code\n\n## Installation\n\n```bash\nnpm install -g apple-notes-mcp\nclaude mcp add --scope user apple-notes -- apple-notes-mcp\n```\n\nOr install directly with npx (no global install needed):\n\n```bash\nclaude mcp add --scope user apple-notes -- npx apple-notes-mcp\n```\n\n## Tools\n\n### Notes (AppleScript path โ€” syncs to iCloud)\n`notes_list` ยท `notes_get` ยท `notes_get_body` ยท `notes_create` ยท `notes_edit` ยท\n`notes_delete` ยท `notes_undelete` ยท `notes_empty_trash` ยท `notes_move` ยท `notes_duplicate` ยท\n`notes_pin` ยท `notes_search` ยท `notes_export` ยท `notes_import` ยท `notes_open` ยท\n`notes_word_count` ยท `notes_get_sharing_url` ยท `notes_get_by_url` ยท\n`notes_find_duplicates` ยท `notes_batch_delete` ยท `notes_batch_move` ยท\n`notes_export_folder` ยท `notes_backup` ยท `notes_restore`\n\n### Folders\n`folders_list` ยท `folders_get` ยท `folders_create` ยท `folders_rename` ยท\n`folders_delete` ยท `folders_move`\n\n### Attachments\n`attachments_list` ยท `attachments_get` ยท `attachments_add` ยท\n`attachments_export` ยท `attachments_remove`\n\n### Meta\n`notes_accounts` ยท `notes_stats`\n\n### SQLite fast path (no Notes.app required, 50-100ร— faster)\n`sqlite_notes_create` ยท `sqlite_notes_edit` ยท `sqlite_notes_delete` ยท\n`sqlite_notes_move` ยท `sqlite_folders_create` ยท `sqlite_bulk_import` ยท\n`sqlite_notes_restore_bundle`\n\n## Backup & Restore\n\nExport everything from one Mac:\n```\nnotes_backup(\"~/Desktop/my_notes_backup\")\n```\n\nImport on a new Mac (Notes.app must be closed):\n```\nsqlite_notes_restore_bundle(\"~/Desktop/my_notes_backup\")\n```\nThen open Notes.app to sync to iCloud.\n\n## Architecture\n\n- **Reads** โ†’ direct SQLite (instant, no Notes.app needed)\n- **AppleScript writes** โ†’ through Notes.app (guarantees iCloud sync)\n- **SQLite writes** โ†’ direct, Notes.app must be closed, syncs on next open\n","readmeFilename":"README.md"}