apple-mcp

MCP server for macOS Apple apps. Provides 28 read/write tools across Notes, Reminders, Calendar, Contacts, and Safari -- all running locally on your Mac via SQLite and JXA (JavaScript for Automation).

Install

Claude Code

claude mcp add apple -- npx @roebot0/apple-mcp

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "apple": {
      "command": "npx",
      "args": ["@roebot0/apple-mcp"]
    }
  }
}

Tools

Notes (8 tools)

| Tool | Description | |------|-------------| | apple_notes_list | List notes with title, snippet, folder, and dates (paginated) | | apple_notes_search | Search notes by keyword in title and snippet | | apple_notes_get | Get full plaintext body of a note by exact title | | apple_notes_folders | List all folders with note counts | | apple_notes_recent | Get N most recently modified notes | | apple_notes_by_folder | Get all notes in a specific folder | | apple_notes_create | Create a new note in a specified folder | | apple_notes_stats | Aggregate stats: total notes, per-folder counts, date range |

Reminders (6 tools)

| Tool | Description | |------|-------------| | apple_reminders_lists | List all reminder lists with counts | | apple_reminders_list | Get reminders in a specific list | | apple_reminders_due | Get reminders due today, this week, or overdue | | apple_reminders_search | Search reminders by keyword across all lists | | apple_reminders_create | Create a new reminder with optional due date and priority | | apple_reminders_complete | Mark a reminder as complete by name |

Calendar (5 tools)

| Tool | Description | |------|-------------| | apple_calendar_today | Get today's events across all calendars | | apple_calendar_range | Get events in a date range | | apple_calendar_calendars | List all calendars | | apple_calendar_search | Search events by title | | apple_calendar_upcoming | Get next N upcoming events |

Contacts (5 tools)

| Tool | Description | |------|-------------| | apple_contacts_search | Search contacts by name, email, or company | | apple_contacts_get | Get full contact details by ID (emails, phones, etc.) | | apple_contacts_recent | Get recently modified contacts | | apple_contacts_company | List contacts at a specific company | | apple_contacts_stats | Contact count and top companies |

Safari (4 tools)

| Tool | Description | |------|-------------| | apple_safari_history | Get recent browsing history | | apple_safari_search_history | Search history by URL or page title | | apple_safari_bookmarks | List bookmarks, optionally filtered by folder | | apple_safari_reading_list | Get all Reading List items |

Requirements

• macOS (uses native SQLite databases and JXA automation)
• Node.js >= 18
• Full Disk Access required for Safari history -- grant it to your terminal app in System Settings > Privacy & Security > Full Disk Access
• Notes, Reminders, Calendar, and Contacts work without Full Disk Access

How it works

• Notes, Calendar, Contacts, Safari history: Read directly from local SQLite databases (read-only)
• Notes create, Reminders (all), Notes get: Use JXA (osascript -l JavaScript) to interact with the native apps
• Safari bookmarks/reading list: Parse the Bookmarks.plist file

No network requests. No API keys. Everything stays on your Mac.

Development

git clone https://github.com/AaronRoeF/apple-mcp.git
cd apple-mcp
npm install
npm run build

To test locally with Claude Code:

claude mcp add apple -- node /path/to/apple-mcp/start-mcp-server.js

License

MIT