Apple Notes

Read and create notes in Apple Notes via AppleScript bridge (macOS only).

Works with: Claude DesktopCursor

Community server · details last checked

Quick install
npx -y mcp-server-apple-notes

How to install the Apple Notes MCP server

Add this to your Claude Desktop MCP configuration:

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

Add this to your Cursor MCP configuration:

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

Built by ContextBoltThis directory is built by ContextBolt: MCP-native memory and SEO tools that run alongside Apple Notes in the same client.

Explore ContextBolt

The Apple Notes MCP server bridges an agent to the Notes app on macOS using AppleScript. Apple Notes is where an enormous amount of personal thinking ends up precisely because it is frictionless, and it has historically been a closed box as far as any other tool is concerned.

What it actually does

The server talks to the local Notes app. The agent can list notes and folders, read note content, search across them, and create new notes. Everything runs on your machine through macOS automation, with no API key and no cloud service in between.

Practical patterns:

  • ‘Search my notes for anything about this project and summarise what I already decided.’
  • ‘Create a note with the summary of this conversation in my Ideas folder.’
  • ‘Which notes have I not touched in a year that still mention active work?‘

Why use it

Notes accumulates fragments: half-formed ideas, meeting scraps, things typed on a phone and never revisited. That is genuinely valuable context and it is unreachable, because Notes has no useful search and no integration story. Making it readable turns a pile of fragments into something an agent can draw on when you ask what you have already thought about a topic.

Gotchas

The permissions step is what trips people up. macOS requires explicit automation permission for one app to control another, and until you grant it in System Settings the server fails quietly rather than helpfully. It is macOS only and needs the app present, so no Windows and no headless use. Locked notes are not accessible, correctly. And AppleScript bridges are slow on large libraries, so a search across thousands of notes takes noticeably longer than you would expect.

Built by ContextBolt

This directory is built by ContextBolt

We build MCP-native tools that give your AI the context it cannot reach on its own. Bookmarks turns your saved posts into agent-queryable memory. SEO puts live keyword and ranking data inside Claude. Both run alongside Apple Notes in the same client.

Explore the products →

Apple Notes MCP server: FAQs

Does my note content leave my Mac?

Only through the conversation. The bridge itself is local; nothing is uploaded to a third-party service by the server.

Why does it silently do nothing on first run?

Almost always automation permissions. macOS needs to be told your terminal or client may control Notes, in System Settings under Privacy and Security.

Does it work on iPhone?

No. It drives the Mac app. Notes created on your Mac sync to iOS through iCloud as normal.

Can it read locked notes?

No. Locked notes stay locked, which is the correct behaviour.