mcp-apple-notes

The Apple Notes MCP Server exposes a natural-language interface to interact with your Apple Notes via Model Context Protocol. It lets you create notes, search existing notes by query, and retrieve full content for a given note title. The server is designed to work with Claude Desktop or other AI assistants, enabling you to manage your Apple Notes from within your AI-driven workflows. Available tools include: Create Note, which takes a title, content, and optional tags to create a new note; Search Notes, which accepts a query string to locate relevant notes by title; and Get Note Content, which fetches the full content of a note by its exact title. To run the server locally, start the MCP server and point your client configuration (such as Claude Desktop) to the apple-notes endpoint. The server handles Apple Notes via the included AppleScript integration and TypeScript-based management utilities.

Prerequisites:

• macOS with Apple Notes app configured
• Node.js v20.0.0 or higher
• Yarn package manager

Installation steps:

1. Clone the repository:

git clone https://github.com/Siddhant-K-code/mcp-apple-notes.git
cd mcp-apple-notes

2. Install dependencies:

yarn install

3. Build the project (if applicable):

yarn build

4. Start the server locally:

yarn start

5. Optional: configure Claude Desktop to connect to this MCP server by editing claude_desktop_config.json with:

{
  "mcpServers": {
    "apple-notes": {
      "command": "yarn",
      "args": ["start"],
      "cwd": "/path/to/mcp-apple-notes"
    }
  }
}

Note: You may need to authorize the script to access Apple Notes when first running commands.

Tips and notes:

• Ensure Apple Notes is configured with iCloud for seamless access across devices.
• Use descriptive titles to improve searchability.
• If you modify code, re-run yarn build (if applicable) before starting the server.
• The MCP server relies on AppleScript integration; ensure the running environment has sufficient permissions to control Apple Notes.
• If you run into permissions or AppleScript prompts, grant the necessary permissions in System Settings (Security & Privacy).