Apple Notes MCP Server

An MCP (Model Context Protocol) server that lets Claude interact with Apple Notes on macOS. Since Apple Notes has no REST API, this server uses AppleScript (via osascript) to automate Notes.app.

Features

• Notes: List, read, create, update, and delete notes
• Folders: List and create folders
• Search: Full-text search across all notes
• Accounts: List available accounts (iCloud, On My Mac, etc.)
• Move: Move notes between folders

Prerequisites

• macOS (Apple Notes is macOS-only)
• Node.js 18+
• Apple Notes.app

Installation

git clone https://github.com/bfeeny/Apple-Notes-MCP.git
cd Apple-Notes-MCP
npm install
npm run build

macOS Permissions

The first time you run the server, macOS will prompt you to grant Automation access. You can also configure this manually:

1. Open System Settings → Privacy & Security → Automation
2. Find your terminal app (Terminal, iTerm2, VS Code, etc.)
3. Enable the toggle for Notes

If you see Not authorized to send Apple events errors, this permission hasn't been granted.

Usage with Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "apple-notes": {
      "command": "node",
      "args": ["<path-to-repo>/dist/index.js"]
    }
  }
}

Usage with Claude Code

claude mcp add apple-notes node <path-to-repo>/dist/index.js

Available Tools

Tool	Description
list_notes	List notes, optionally filtered by folder/account
get_note	Get the full content of a note by ID
create_note	Create a new note in a specified folder
update_note	Update the title or body of an existing note
delete_note	Permanently delete a note
list_folders	List all folders, optionally filtered by account
create_folder	Create a new folder
move_note	Move a note to a different folder
search_notes	Search notes by text content
list_accounts	List all available Notes accounts

Development

npm run dev    # Run with ts-node
npm run build  # Compile TypeScript
npm start      # Run compiled output

Known Limitations

• Tags are not exposed in the macOS AppleScript dictionary
• Pinned notes cannot be pinned/unpinned programmatically
• Rich text, tables, and drawings are not accessible — only text content
• Large note libraries may be slow due to AppleScript iteration
• Password-protected notes cannot be read or modified

License

MIT