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:

Open System Settings → Privacy & Security → Automation
Find your terminal app (Terminal, iTerm2, VS Code, etc.)
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