Apple Notes MCP

Apple Notes MCP Server

English | 简体中文

Let Claude read and edit your Apple Notes — with native formatting, tables, attachments, and iCloud sync.

Claude edits your notes the way you would: change one line or tick a checkbox, and the rest of the note stays exactly as it was — colors, fonts and all. Titles, headings, lists, checklists, tables and highlights are real Apple Notes styles. Claude can also look at the images, scans and PDFs in your notes, and keep your folders tidy.

Requires: macOS 26 (Tahoe) or later, Node.js 24+, and Claude Code, Claude Desktop (including Cowork and Code sessions) or claude.ai. Other MCP clients work too: it speaks MCP 2026-07-28 and the older initialize handshake (2024-11-05 to 2025-11-25)

Setup

1. Add to Claude

Claude Code — run in Terminal:

claude mcp add apple-notes -- npx -y @ailenshen/apple-notes-mcp@latest

Claude Desktop — add to ~/Library/Application Support/Claude/claude_desktop_config.json, then restart Claude:

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

claude.ai (web and mobile) — see Remote Access.

@latest makes it update itself: each time Claude starts the server, npx checks for a new version and fetches it.

2. Grant permissions

A setup window opens the first time it's needed (or run npx -y @ailenshen/apple-notes-mcp@latest setup). Turn on two switches for Apple Notes MCP:

You only do this once — permissions stay through updates.

3. Start using it

Just talk to Claude:

• "What did I change in my notes this week?"
• "In my shopping list, tick off milk and add eggs"
• "Add a 'Next steps' section to the meeting note"
• "What's in the photo in my receipts note?"
• "Move the Hainan trip notes into Travel"
• "Write a one-line description for every note in Work"
• "Archive the Old Projects folder to ~/Documents/Archive/old-projects.zip, then delete it"

What Can It Do?

Claude never overwrites your own edits: if a note changed after Claude read it, the write is refused. Every note is backed up before a change.

Markdown in Notes

Remote Access

The server talks over stdio. To use it from claude.ai, put it behind a bridge that forwards HTTP requests to stdio, then add the URL as a custom connector.

Upgrading from 1.x

Version 2 is a rewrite in Swift, and @latest installs it automatically. What changes:

• It needs macOS 26 (Tahoe). On an older Mac, use version 1: npx -y @ailenshen/apple-notes-mcp@1.
• Permissions now belong to the Apple Notes MCP app. The setup window opens once; turn on the two switches.
• Restart Claude, or reconnect the connector, once.
• The --http mode is gone; see Remote Access. To keep it, stay on @1.

How It Works

• Reading goes through Notes' own data framework, read-only.
• Writing changes only what differs, through Notes' own editing objects, so the rest of the note — including formatting Markdown can't show — is untouched.
• Syncing: after each change, Notes is asked to upload it to iCloud.
• Notes never comes to the front, and no dialogs pop up.

Known Limitations

• Attachments can be read, not added or removed.
• Folders can't be moved yet.
• Locked notes can't be read; an export lists them as not exported. Shared notes can be edited, but not deleted.
• A table you just edited in Notes is rebuilt when Claude changes it, which resets formatting inside its cells.

Vision

Apple Notes is the most natural place to keep personal knowledge on Apple devices — it syncs everywhere, it's fast, and it's private. But it's a walled garden with no API.

This project makes Apple Notes a first-class data source for AI. The long-term goal: wherever you're talking to AI — on your Mac, on your phone, on the web — your Apple Notes are always accessible, readable, and writable.

License

MIT