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

Related MCP server: Apple Notes MCP Server

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

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