Apple Notes MCP MCP Server

Apple Notes MCP (sweetrb/apple-notes-mcp) is a community-maintained Model Context Protocol server that bridges AI assistants like Claude with the Apple Notes app on macOS. It uses AppleScript to talk to Notes.app, so all data stays local and no cloud APIs or keys are involved. The server exposes a broad set of tools covering note CRUD, folder management, batch operations, exports, and diagnostics.

Capabilities include creating, searching, reading, updating, deleting, and moving notes, plus creating and listing folders with hierarchical paths like Work/Clients. It supports batch delete and move by ID, JSON export of all notes, Markdown conversion for individual notes, checklist state inspection, and attachment listing. Diagnostics tools provide health checks, sync status, shared notes detection, and overall statistics. The server also works across multiple configured Notes accounts (iCloud, Gmail, Exchange).

Note: this is a community implementation, not an official Apple product. Several other "Apple Notes MCP" projects exist with different feature sets (some read-only, some focused on semantic search and RAG). This one is the closest match for users who want full read, write, and organize coverage from a single server.

Tools

Prerequisites

• macOS (Apple Notes and AppleScript are macOS-only)
• Node.js 20+
• At least one configured Notes account in the Notes app
• Full Disk Access for the host process if you want to read checklist state

Install

Install globally from GitHub:

npm install -g github:sweetrb/apple-notes-mcp

Configure Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "apple-notes": {
      "command": "npx",
      "args": ["apple-notes-mcp"]
    }
  }
}

Restart Claude Desktop. On first use, macOS will prompt for permission to control Notes.app via automation: click OK. No API keys are required.

• Capture meeting takeaways directly into a structured Apple Notes folder by asking Claude to summarize a transcript and create a note in Work/Meetings.
• Search across all notes for any mention of a project or person and have Claude draft a follow-up update note in the same folder.
• Bulk reorganize: list notes in a folder, then batch-move stale items into an Archive/2025 folder by ID.
• Export your entire Notes library to JSON for backup or to feed into another pipeline.
• Convert a long note to Markdown for pasting into a doc, PR description, or static site.

• "Create a note called 'Q3 launch plan' in the Work/Planning folder with these bullet points..."
• "Search my Apple Notes for anything mentioning 'Acme renewal' and summarize what I have."
• "List all notes in the Personal folder, then move the ones older than 2024 into Archive."
• "Export all my notes as JSON so I can back them up."
• "Convert the note titled 'Onboarding checklist' to Markdown."

• Broad tool coverage: full CRUD on notes plus folder management, batch ops, exports, and diagnostics.
• Fully local: uses AppleScript against Notes.app, no API keys or cloud calls.
• Works across multiple Notes accounts (iCloud, Gmail, Exchange).
• Simple install via npm and a minimal Claude Desktop config.

• Community-maintained, not an official Apple project.
• macOS-only and dependent on AppleScript, which can be slow for large libraries and may not preserve complex rich formatting.
• Cannot access password-protected notes or attachment content; checklist state reading requires Full Disk Access.

• sirmews/apple-notes-mcp: Python server published as apple-notes-mcp on PyPI, read-only over the Notes SQLite database, requires Full Disk Access.
• RafalWilinski/mcp-apple-notes: Focused on semantic search and RAG over Apple Notes using LanceDB and on-device embeddings.
• PsychQuant/che-apple-notes-mcp: Hybrid SQLite read plus AppleScript write with a large tool surface and undo/redo.