ailenshen/apple-notes-mcp

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 Desktop** — add to ~/Library/Application Support/Claude/claude_desktop_config.json, then restart Claude:
**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**:
| Permission | Why |
|-----------|-----|
| **Full Disk Access** | Read your notes |
| **Automation → Notes** | Sync changes to iCloud, move and delete notes |
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?
| Tool | Description |
|------|-------------|
| overview | Folders, or notes with their size and a one-line description; filter by date, sort by date or title |
| search | Full-text search, with the matching text |
| read_note | Read a note as Markdown — by id or title, several at once, or just one section |
| read_attachment | Look at an image, scan, PDF, video, table or file in a note |
| create_note | New note from Markdown |
| edit_note | Change text, add under a heading, or rewrite a note — several changes in one go |
| describe_note | Save one-line descriptions, many at once |
| move_note | Move a note to another folder, or restore it from Recently Deleted |
| manage_folder | Create, rename or delete a folder; export a folder to disk (Markdown + original attachments, optionally as a .zip), or delete it with everything in it |
| delete_note | Move to Recently Deleted |
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
| In Notes | In Markdown |
|---------|-------------|
| Title / Heading / Subheading | # / ## / ### |