Skip to content
MCP server

Apple Notes

Search, read and write Apple Notes on a Mac, with edits off by default

Runs locallyStatus and history
Pricing
Free trial
Platforms
macOS, CLI
Runs
Locally
Version
1.40.0
Listing updated
3 days ago

About Apple Notes

Apple Notes is an MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

Notes can be limited to specific accounts: APPLE_NOTES_ACCOUNTS restricts every read and write by account name, and attachments can only be saved into one directory (default ~/Downloads). Bodies are truncated at 262,144 bytes by default to protect the model's context window.

Eight read tools cover diagnostics, accounts, folders, notes, search, getting a note, listing and saving attachments. The five write tools, create_note, update_note, move_note, delete_notes and add_attachment, are registered only when APPLE_NOTES_ALLOW_WRITES=1; with it off they are invisible to the model. add_attachment is the only way to put an image into a note.

Two permissions matter: Automation for Notes is required for everything, while Full Disk Access enables search at scale and save_attachment; without it the server runs on the slower Apple Events path. MIT licensed, unofficial, macOS 26 or later.

Install

Run in a terminal

claude mcp add mcp-apple-notes -- npx -y @mgcrea/mcp-apple-notes

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-apple-notes": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-notes"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-apple-notes": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-notes"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-apple-notes": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-notes"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-apple-notes": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-notes"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-apple-notes": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-notes"
      ]
    }
  }
}

Configuration

  • APPLE_NOTES_ALLOW_WRITESRegister the mutating tools. Off by default, and the gate decides whether the write tools exist at all rather than merely refusing — an agent with writes off cannot see them.
  • APPLE_NOTES_ACCOUNTSRestrict every read and write to these Notes accounts, by name.

Tools this server provides (13)

Taken from the project documentation; the running server may differ.

diagnostics
No description
list_accounts
No description
list_folders
No description
list_notes
No description
search_notes
No description
get_note
No description
list_attachments
No description
save_attachment
No description
create_note
No description
update_note
No description
move_note
No description
delete_notes
No description
add_attachment
No description

What it does

Account allowlist
Restrict reads and writes to named Notes accounts.
Read tools
Browse folders, search and fetch notes.
Gated writes
Create, update, move and delete exist only when enabled.
Attachment handling
List and save attachments; add images with add_attachment.
Body size cap
Truncates note bodies to protect context.

Good for

  • Search personal notes during an agent task
  • Turn meeting notes into a summary
  • Create a note from an agent after enabling writes
  • Save an attachment from a note to Downloads

Pricing

Free trial

Servers MIT; Cupertino app has a 30-minute trial and 30-day refund; price not published

Prices change. Check cupertino.mgcrea.io before you buy.

Apple Notes FAQ

What permissions are needed?

Automation for Notes for everything; Full Disk Access for search at scale and save_attachment.

Can an agent delete notes by default?

No. Write tools are invisible unless APPLE_NOTES_ALLOW_WRITES=1.

How do I limit which notes it sees?

Set APPLE_NOTES_ACCOUNTS to a comma-separated list.

Is Apple Notes free?

Apple Notes is a paid product with a free trial.

How do I add Apple Notes to Claude Code?

Run this command in your terminal: claude mcp add mcp-apple-notes -- npx -y @mgcrea/mcp-apple-notes

What are the best alternatives to Apple Notes?

The closest alternatives to Apple Notes are Codebase Memory, XERJ, Ha MCP, Claude Code Ultimate Guide and Nautilus Compass Memory.

Alternatives to Apple Notes

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  4. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  5. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  6. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools