@ahofmcpserver/apple-notes-mcp
v1.0.4
Published
Full Apple Notes MCP server — create, edit, search, manage folders and attachments, backup and restore, full-fidelity vault import.
Maintainers
Readme
apple-notes-mcp
Full Apple Notes MCP server for Claude Code. 44 tools covering every Notes operation.
Requirements
- macOS (uses Apple Notes and NoteStore.sqlite)
- Python 3.9+ (
brew install python3) - Claude Code
Installation
npm install -g apple-notes-mcp
claude mcp add --scope user apple-notes -- apple-notes-mcpOr install directly with npx (no global install needed):
claude mcp add --scope user apple-notes -- npx apple-notes-mcpTools
Notes (AppleScript path — syncs to iCloud)
notes_list · notes_get · notes_get_body · notes_create · notes_edit ·
notes_delete · notes_undelete · notes_empty_trash · notes_move · notes_duplicate ·
notes_pin · notes_search · notes_export · notes_import · notes_open ·
notes_word_count · notes_get_sharing_url · notes_get_by_url ·
notes_find_duplicates · notes_batch_delete · notes_batch_move ·
notes_export_folder · notes_backup · notes_restore
Folders
folders_list · folders_get · folders_create · folders_rename ·
folders_delete · folders_move
Attachments
attachments_list · attachments_get · attachments_add ·
attachments_export · attachments_remove
Meta
notes_accounts · notes_stats
SQLite fast path (no Notes.app required, 50-100× faster)
sqlite_notes_create · sqlite_notes_edit · sqlite_notes_delete ·
sqlite_notes_move · sqlite_folders_create · sqlite_bulk_import ·
sqlite_notes_restore_bundle
Backup & Restore
Export everything from one Mac:
notes_backup("~/Desktop/my_notes_backup")Import on a new Mac (Notes.app must be closed):
sqlite_notes_restore_bundle("~/Desktop/my_notes_backup")Then open Notes.app to sync to iCloud.
Architecture
- Reads → direct SQLite (instant, no Notes.app needed)
- AppleScript writes → through Notes.app (guarantees iCloud sync)
- SQLite writes → direct, Notes.app must be closed, syncs on next open
