🍎 macOS Personal MCP

Your Mail and Calendar, connected to ChatGPT. Contacts too, with a compatible host.

You know the answer is somewhere on your Mac. A date buried in an email, a meeting in your calendar, a contact whose address you can never remember. Ask your AI to find it, read it and help you act on it.

macOS Personal MCP connects an AI assistant to the Apple apps you already use, with the accounts you already have. It works locally on your Mac and starts read-only. You can enable sending emails and creating calendar events when you're ready.

Apple Silicon Mac · ChatGPT desktop with local MCP support · AGPLv3

✨ A little less app-hopping

Imagine getting ready for tomorrow. Your calendar has the meeting, Mail has the conversation, and Contacts has the person you need to follow up with. Now you can bring that context into one conversation:

What's on my calendar tomorrow? Find the recent emails about those meetings and help me prepare.

Or start with the small things that eat up your day:

• 🔎 Find what you half-remember. “Find the email containing ‘existing credits’ from the past three days, and read me the relevant part.”

• 📧 Catch up on a conversation. “Find this week's emails about the project deadline and summarize what changed.”

• 👥 Follow up. “Look up Alex's email address and draft a reply here for me to review.”

• 📅 Put it in the calendar. With event creation enabled: “Add a 30-minute preparation block tomorrow morning to my work calendar.”

The assistant can search email subjects, senders and full locally available bodies, read messages, check calendars and look up contacts. Optional sends and event creation show a confirmation dialog by default.

Related MCP server: Mailbridge for Apple Mail

💡 Why this exists

Apple MCP showed how useful it could be to let an AI work with the apps already on a Mac. This project takes that idea into everyday Mail, Calendar and Contacts workflows, with particular care for finding the email you actually need and reading it correctly.

There are no separate Gmail, Microsoft or iCloud API keys to configure. Mail search reuses local Mail data and, for larger searches, Apple's existing search index. You don't need to build or maintain a second email index to get started.

Local access, with a clear data boundary: this MCP runs on your Mac and adds no separate mail-provider connection. The messages and other data you ask it to retrieve are returned to your AI app and handled under that app's data policy. Your native Apple apps continue to sync normally.

🚀 Get started: let your AI install it

Copy this into ChatGPT desktop with local computer/Terminal access, Codex, or another agent that can run commands on your Mac:

Install https://github.com/UliPrantz/macos-personal-mcp on my Mac for ChatGPT
desktop. Follow docs/INSTALL_WITH_AGENT.md and handle setup, configuration and
verification yourself. Inspect any existing checkout, preserve my other MCPs
and approval settings, and start new installs read-only. Ask me only for macOS
permission dialogs or a restart you cannot complete yourself.

The agent handles installation and connecting the tools. You approve any macOS permission dialogs. No GitHub account is needed. An agent running only in a cloud browser cannot install software on your Mac.

Compatibility: requires an Apple Silicon Mac. Full archive body search is currently validated only on macOS 26.5.2; other versions have no validated large-scope body-search support. Compatibility and troubleshooting. Contacts requires a compatible calling app. A hardened-runtime host needs Apple's Contacts entitlement, a usage description and your macOS permission. The tested direct ChatGPT desktop build 26.1021.31345 lacks those Contacts declarations; neither a Settings toggle nor the optional Automation backend fixes that. Contacts support stays available for compatible hosts and future app updates. Compatibility details.

You'll need Git, internet access and ChatGPT desktop with local MCP support. The installer supplies Python and dependencies inside the checkout.

1. Install. For a new checkout, paste into Terminal:

mkdir -p ~/Developer/Projects
git clone https://github.com/UliPrantz/macos-personal-mcp.git ~/Developer/Projects/macos-personal-mcp
cd ~/Developer/Projects/macos-personal-mcp
sh scripts/install.sh

If prompted to install Apple's Command Line Tools, finish that installation and rerun the commands. The first install can take several minutes. Keep the checkout at this location. If it already exists, inspect it before updating.

2. Connect. Open ChatGPT → Settings → MCP servers → Add server:

Save and Restart that connection.

3. Allow access and try it. Ask ChatGPT to run doctor and follow its next_actions. For an eligible host with not_determined access, ask it to call request_permissions for that feature, then approve the macOS dialog. There may be no Settings entry until that first request. For the known ChatGPT Contacts block above, continue with Mail and Calendar; repeated requests will not fix it. Permission help. If Mail-file search is denied, check System Settings → Privacy & Security → Full Disk Access for the app or helper running the MCP, then restart it if macOS requests that. Ask ChatGPT:

Check macos-personal with doctor, then find emails about the project deadline
from the past three days and read the most relevant result. Report incomplete
search coverage.

You should be able to search and read a result from ChatGPT. No manual indexing or separate mail-provider login is needed. Detailed setup and removal.

New installations start read-only. To enable these actions, replace the server arguments with:

serve --enable-mail-send --enable-calendar-create --enable-calendar-open

Restart the connection. Sends and event creation ask for native human confirmation by default. You can also deliberately delegate approval handling to your AI app through approval configuration. Calendar invitations and adding attendees are not supported.

Known Mail formatting limitation: scripted bodies can arrive with an extra leading blank line and quote indentation, even when draft readback matches the reviewed text. Sending still works; the native formatting problem remains unresolved. Investigation and rejected workarounds.

Emails can reply to an exact original message with Mail's native threading. Recipients and body stay explicit for review; Re: alone only suggests grouping to the recipient's client. Reply behavior and limits.

Bodies accept Unicode plain text, with full URLs; rich HTML/Markdown formatting is not supported. Attachments use local files, within size/count limits. Mail read/unread status can be inspected and filtered, but there is no tool to change it. Verified Mail capabilities and limits for agents.

Add --enable-mail-compose to your server arguments and remove --read-only. For draft opening alone, use:

serve --enable-mail-compose

Restart the connection, then ask: “Open an email draft to Alex about tomorrow's meeting, with the text we just wrote.” The mail_compose tool opens a prefilled composer in your default email app using mailto:, avoiding the scripted Mail body setter associated with the blank-line issue above. Choose the sender, add attachments and send it yourself. The tool does not save or send; your email app may autosave. This works without enabling automatic sends or granting Mail-file access. Example and limits.

🎯 What to expect today

Search, message reads and Calendar have been tested through actual desktop tools. Contacts reads also work through an authorized launcher, but remain blocked in the tested direct ChatGPT host described above. Recent-mail searches are usually quick in our measured scopes; larger archive searches can take several seconds. Keywords, exact phrases, date ranges and limited typo matching work. Semantic search is not implemented.

Search depends on what's available locally. Missing or partial bodies and index gaps are reported, so an incomplete search isn't presented as proof that an email doesn't exist. Measured results and current limits.

More everyday examples · Installation help · Report a problem

• How the tools work and their limits

• Search syntax, native index, coverage and optional legacy cache

• Read-only mode, optional writes and approval settings

• Permission states, native dialogs and the right Settings entry

• Development and verification

• What we learned from other Apple Mail MCPs

• Agent installation runbook

License and credit

Copyright © 2026 Uli Prantz. GNU AGPLv3 only, with third-party notices preserved. Commercial use is allowed under the license; it does not require royalties or reporting your usage.

Using this commercially? I'd love to hear about it. That's a voluntary invitation, not an extra license condition.