A bridge for interacting with macOS Messages app through MCP
Listed on its own since 2026-09-24. Until then it was part of carterlasalle-mac-messages-mcp, where its earlier checks remain.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"mac-messages-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Mac Messages MCP Use Claude, Codex, Cursor, VS Code, or any local MCP client to search, read, and send messages through the macOS Messages app. [](https://pypi.org/project/mac-messages-mcp/) [](https://pypi.org/project/mac-messages-mcp/) [](https://github.com/carterlasalle/mac_messages_mcp/actions/workflows/ci.yml) [](https://pepy.tech/project/mac-messages-mcp) [](LICENSE) Mac Messages MCP runs locally on your Mac. It opens the Messages and Contacts databases read-only, returns only the data a client asks for, and uses Messages.app automation only when the client explicitly calls the send tool. > [!IMPORTANT] This server is macOS-only. Reading messages requires Full Disk > Access. Sending requires a Mac signed into Messages plus permission for the > launching app to automate Messages. ## What it can do - Read recent messages across all conversations or filter by contact or group chat - Fuzzy-search message text across a time window, including all available history - Find Contacts by approximate name and return send-ready phone numbers - List named group chats and use their chat IDs for reads or sends - Send iMessage, with SMS/RCS fallback for eligible phone recipients - Check whether a recipient appears reachable through iMessage before sending - Find attachments by date, sender, and MIME type - Return small images inline, convert HEIC images to PNG, or return a local path for larger and non-image files - Diagnose Messages and Contacts database permissions from inside the MCP client ## Quick start ### 1. Install `uv` ```bash brew install uv ``` Confirm that the …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.