Apple Notes MCP Server

An MCP (Model Context Protocol) server for interacting with Apple Notes on macOS.

Features

• List notes from all accounts or specific accounts/folders

• Search notes by content

• Read note content

• Create new notes

• Update existing notes

• Delete notes

• List available accounts

Requirements

• macOS (uses AppleScript to interact with Notes app)

• Python 3.10+

• Notes app must be installed and accessible

Notes

• The server uses AppleScript to interact with the Notes app

• You will need to grant Terminal/iTerm/Cursor PERMISSION to control Notes in System Preferences > Security & Privacy > Accessibility

• Account names are case-sensitive (e.g., "iCloud" vs "icloud")

Installation

git clone https://github.com/arslankhanali/apple-notes-mcp.git
cd apple-notes-mcp
uv venv
source .venv/bin/activate
uv add "mcp[cli]"

# To run
# uv run apple_notes.py

Usage with Cursor

Add to your MCP configuration (~/.cursor/mcp.json):

Change /path/to/apple-notes-mcp to where you cloned this repo

{
  "mcpServers": {
    "apple-notes": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/apple-notes-mcp",
        "run",
        "apple_notes.py"
      ]
    }
  }
}

Available Tools

• list_notes - List all notes or notes from a specific account/folder

• search_notes - Search for notes containing specific text

• read_note - Read the content of a specific note

• create_note - Create a new note with title and content

• update_note - Update the content of an existing note

• delete_note - Delete a note

• list_accounts - List all available Notes accounts