Homeport
Apple Calendar, Reminders, Contacts, Notes, Messages and Shortcuts for AI, over Tailscale
- Transport
- Not stated
- Package
- —
- Registry id
- io.github.CapitalX/homeport
No install snippet on purpose. A working MCP config is a command, its arguments and an environment block — the last two are where API keys live, so this catalogue never stores them and cannot publish them. Follow the link above for the authors' own instructions.
Your Mac's Calendar, Reminders, Contacts, Notes, Messages, Voice Memos and Shortcuts — available to your AI from any of your devices, with nothing exposed to the internet.
Homeport is a Model Context Protocol server that runs headless on a Mac and answers from anywhere on your private Tailscale network.
Built on Apple's own EventKit, Contacts and Speech frameworks. No AppleScript guesswork, no Node, no Python runtime for the server, no cloud service. One code-signed Swift binary that is both the MCP server and the framework engine.
Open the interactive diagram → guided views, relationship tracing, search, light and dark
Why another Apple MCP server?
Most are stdio-only: your chat client spawns them, and they die with it. That has two consequences — the permission grant belongs to the client, not the server, and nothing can reach your data unless it's running on that same Mac.
Homeport is different in three ways:
- 🔌 It's a daemon, not a subprocess. Runs under
launchd, outlives every client, and serves over HTTP so your phone can query your Mac's calendar from another continent. - 🪪 It owns its own permissions. A disclaim shim (
responsibility_spawnattrs_setdisclaim) makes the binary its own TCC-responsible process, so grants attach to this code rather than to whichever app launched it. One identity, six frameworks, grants that survive rebuilds. - 🛡️ It assumes its inputs are hostile. Everything it returns — a stranger's iMessage, an emailed calendar invite, a shared note — is fenced as untrusted data before a model ever sees it.
👥 Who it's for
Homeport is for people who keep their lives in Apple's apps, use an AI assistant for real work, and are comfortable in a terminal. In particular:
- You have a Mac that stays on, and you work from other devices. An always-on Mac at home, and a Linux laptop, a Windows PC, a phone or a server-side agent that should be able to reach your calendar, reminders, contacts and notes. This is what Homeport does that stdio-only servers can't: it serves over Tailscale, with no API keys to manage and nothing on the public internet.
- You want your AI to actually manage your Apple apps, not just read them. Recurrence and alarm writes, full contact editing with duplicate merging, bulk reminder cleanup, local-model routing of captured reminders into the right lists, and scheduling around your real calendar. And permissions that don't break after every rebuild.
- You're wary of handing an AI your messages and contacts. Externally authored text is fenced as untrusted, sending is restricted to an allowlist, the audit log records actions but never content, Notes folders can be made write-only, and summaries can run on a local model so nothing leaves your machines.
- Niche, but well served: people who record meetings or lectures on their iPhone (on-device transcription, local summaries filed into Notes); Shortcuts builders (build and sign shortcuts from code, and turn any shared iCloud link back into its actions); and developers building their own macOS MCP tools, for whom the notes on TCC, code signing and what Shortcuts really allows may be worth the read alone.
From the project's README.