Apple Productivity MCP

An on-demand, localModel Context Protocol (MCP)server that gives Claude Code and Codex controlled access to Apple Mail, Calendar, and Reminders on macOS.

claude mcp add --transport stdio --scope user apple-productivity-local -- \ npx -y @gambadio/apple-productivity-mcp@latest

claude mcp get apple-productivity-local claude mcp list

codex mcp add apple-productivity-local -- \ npx -y @gambadio/apple-productivity-mcp@latest

codex mcp get apple-productivity-local codex mcp list

{ "mcpServers": { "apple-productivity-local": { "command": "npx", "args": [ "-y", "@gambadio/apple-productivity-mcp@latest" ] } } }

The outer configuration key and file location vary by client. In a graphical setup screen, selectSTDIOand enter the command and arguments from the table. This pattern applies to local MCP clients such as Claude Desktop, Cursor, Windsurf, Cline, and compatible editors; consult the client's documentation for where it stores MCP configuration.

If a desktop client cannot findnpx, run this in Terminal:

Then replace"command": "npx"with the returned absolute path, for example"command": "/usr/local/bin/npx".

Restart the client or open a new session after changing its MCP configuration. Clients that support only remote HTTP servers cannot run this MCP directly because Apple Productivity MCP intentionally uses local stdio and macOS automation.

You donotneed to runnpm start, install the package globally, keep a terminal open, configure an API key, or expose a network port.

Use a source checkout when developing the server or when you want to run a specific Git commit.

Clone the repository and install its locked dependencies:

git clone https://github.com/gambadio/apple-productivity-mcp.git cd apple-productivity-mcp npm ci

Capture the absolute paths that the MCP clients should store:

APPLE_MCP_NODE="$(command -v node)" APPLE_MCP_SERVER="$(pwd)/src/index.js"

Paths containing spaces are supported. Keep the quotes in the commands below.

Install the server for your user account:

claude mcp add --transport stdio --scope user apple-productivity-local -- \ "$APPLE_MCP_NODE" "$APPLE_MCP_SERVER"

claude mcp get apple-productivity-local claude mcp list

Install the same local stdio server in Codex:

codex mcp add apple-productivity-local -- \ "$APPLE_MCP_NODE" "$APPLE_MCP_SERVER"

codex mcp get apple-productivity-local codex mcp list

Codex stores this in its user configuration, shared by the Codex app, CLI, and IDE extension on the same host. Start a new session after installation. If a desktop app or IDE extension was already open, restart it so it reloads the MCP configuration.

You donotneed to runnpm startor keep a terminal open. The MCP client launches the source checkout as a child process when it establishes the MCP connection.

The first real tool call for each Apple app may trigger a macOS Automation prompt. Approve access for the application that launched the MCP server, such as Terminal, iTerm, Claude Code, Codex, or your IDE.

If you denied a prompt or no prompt appears:
- OpenSystem Settings → Privacy & Security → Automation.
- Find the application that launches your MCP client.
- Enable Mail, Calendar, and Reminders as needed.
- Restart the MCP client and try again.

Start with the discovery tools so the client learns the exact local names configured on your Mac:

- “List my Apple Mail accounts and mailboxes.”
- “List my writable Apple calendars.”
- “List my Apple Reminders lists.”
- “Show events from all calendars tomorrow.”
- “Show my incomplete reminders.”

Mail defaults to the account nameiCloudand mailboxINBOXwhen a caller does not provide names. Useapple_mail_list_accountsfirst if your setup uses different names.

- apple_mail_list_accounts— list account names, sender addresses, and mailboxes
- apple_mail_list— list message metadata without reading bodies
- apple_mail_get— read one message, including its body
- apple_mail_send— send a message immediately
- apple_mail_update_status— mark read/unread or flag/unflag
- apple_mail_move— move a message to another mailbox in the same account
- apple_mail_delete— delete a message using Mail.app behavior

- apple_calendar_list_calendars— list calendar names and writable status
- apple_calendar_list_events— list overlapping events in an ISO 8601 time range
- apple_calendar_create_event— create an event
- apple_calendar_update_event— update an event by UID
- apple_calendar_delete_event— delete an event by UID

- apple_reminders_list_lists— list reminder-list names and IDs
- apple_reminders_list— list reminders, optionally including completed items
- apple_reminders_create— create a reminder
- apple_reminders_update— update a reminder by ID
- apple_reminders_complete— mark a reminder complete
- apple_reminders_delete— delete a reminder by ID

- The MCP server itself has no network listener and stores no credentials or Apple data.
- Inputs are passed toosascriptas JSON arguments rather than interpolated into executable JXA source.
- Mail, Calendar, and Reminders changes can sync through iCloud, CalDAV, Exchange, or another configured provider.
- “Local MCP” describes where the server runs. Content returned to Claude Code or Codex becomes part of that active model session and may be processed according to that product's data controls.
- Sending, moving, updating, completing, and deleting are real actions. Review write-tool requests before approving them.

Registrations using the npm command with@latestresolve the latest published version when a new MCP process starts. Start a new Claude Code or Codex session after a release. Pin an explicit version if automatic upgrades are not desirable.

For a source checkout, update in place so the stored absolute path remains valid:

cd /absolute/path/to/apple-productivity-mcp git pull --ff-only npm ci npm test

claude mcp remove apple-productivity-local --scope user codex mcp remove apple-productivity-local

Removing the registration does not clear npm's cache, delete a cloned repository, or change Apple data.

Install dependencies and run the isolated test suite:

Run the read-only live integration tests after granting Automation permission:

The default test run skips live integration tests because they access the user's installed Apple applications.

Apple automation unavailableor an authorization error

ReviewSystem Settings → Privacy & Security → Automation, enable the affected Apple app for the process that launches your MCP client, then restart the client.

Mail account not found,Calendar not found, orReminder list not found

Run the corresponding discovery tool and use the exact returned name. Names are local to your macOS setup and may differ by language or provider.

For an npm installation, runcommand -v npxand use the returned absolute path as the configured command. For a source checkout, remove and re-add the MCP registration using fresh values fromcommand -v nodeandpwd.

Confirm that the public package is reachable and that the client has internet access for the first installation:

npm view @gambadio/apple-productivity-mcp version

After the package has been downloaded, npm can reuse its local cache for that version.

Server is registered but tools do not appear

Run the client'smcp get/mcp listcommands, then start a new session. Restart an already-open desktop app or IDE extension after changing MCP configuration.

Enables LLM clients to interact with macOS applications through AppleScript. Built using the @beyondbetter/bb-mcp-server library, this server provides safe, controlled execution of predefined scripts with optional support for arbitrary script execution.

On-device tools to detect AI-generated text and images, score readability, and strip AI artifacts, running locally on Apple silicon.

Interact with Apple Notes using natural language on macOS.

A server for native integration with Apple Reminders on macOS.

Execute AppleScript to gain full control of your Mac.

Native macOS Calendar & Reminders MCP server with 24 tools using Swift EventKit - supports recurring events, location triggers, search, batch operations

Native macOS Calendar & Reminders MCP server via Apple EventKit — events, reminders, recurrence, location triggers, conflict checks, and batch ops across iCloud/Google/Exchange.

An MCP server for integrating with the Claude Desktop application on macOS. Requires the Claude Desktop app to be installed and configured.

Read-only MCP endpoint for a managed dedicated Mac mini AI operator setup service with public pricing and a 10-founder-install queue.