Mac Messages MCP Server

Content

Mac Messages MCP Server connects Claude and other MCP clients to the local macOS Messages app. It can read recent messages, search conversations, list group chats, resolve contacts, check iMessage availability, search attachment metadata, fetch attachments, and send outbound messages through Messages.

Use it when a macOS automation workflow needs local Messages context or explicitly approved outbound messaging. Because it reads personal communications and can send real messages, start with read/search workflows and require confirmation for every outbound send.

Source Review

• https://github.com/carterlasalle/mac_messages_mcp
• https://raw.githubusercontent.com/carterlasalle/mac_messages_mcp/main/README.md
• https://pypi.org/pypi/mac-messages-mcp/json
• https://raw.githubusercontent.com/carterlasalle/mac_messages_mcp/main/LICENSE
• https://raw.githubusercontent.com/carterlasalle/mac_messages_mcp/main/pyproject.toml
• https://raw.githubusercontent.com/carterlasalle/mac_messages_mcp/main/manifest.json
• https://raw.githubusercontent.com/carterlasalle/mac_messages_mcp/main/mac_messages_mcp/server.py
• https://raw.githubusercontent.com/carterlasalle/mac_messages_mcp/main/mac_messages_mcp/messages.py
• https://raw.githubusercontent.com/carterlasalle/mac_messages_mcp/main/glama.json

These sources were reviewed on 2026-06-06. Prefer the live repository, README, PyPI metadata, license, package metadata, MCPB manifest, server tool definitions, Messages implementation, and registry metadata for current setup and operating details.

Features

• Read recent Messages within a configurable time window.
• Filter recent messages by contact, phone number, email address, or group chat ID.
• Fuzzy-search message content with match scoring.
• Find contacts by fuzzy name matching.
• Check Messages database, Contacts, and AddressBook access diagnostics.
• List named group chats and chat IDs.
• Check whether a recipient appears reachable through iMessage.
• Send one outbound message to an individual contact or group chat.
• Search attachment metadata by date range, contact, MIME type, and limit.
• Fetch attachments by ID, returning small images inline or local paths for larger and non-image files.
• Normalize common phone-number formats before sending.
• Run as a local Python MCP server through uvx.
• Package an MCPB extension for Claude Desktop from the repository manifest.

Installation

Grant Full Disk Access to the host application that will run the server, then add it to an MCP client:

{
  "mcpServers": {
    "messages": {
      "command": "uvx",
      "args": ["mac-messages-mcp"]
    }
  }
}

Use diagnostic tools first:

tool_check_db_access
tool_check_addressbook
tool_check_contacts

Only after permissions and contact matching are verified should you allow outbound message sends.

Use Cases

• Summarize recent messages from a specific contact or group chat.
• Search older conversations for a phrase, decision, date, or attachment.
• Find a contact before drafting a response.
• Retrieve an image or document attachment after confirming the attachment ID.
• Check whether a number is reachable through iMessage.
• Draft and send a single confirmed message through the local Messages app.
• Build local notification, follow-up, or personal assistant workflows on macOS.

Safety and Privacy

Mac Messages MCP Server touches personal communications. Full Disk Access can expose the local Messages database, Contacts permission can expose address-book entries, and attachment fetches can expose private media or documents. Keep message reads scoped by contact, time window, or chat ID whenever possible.

The send tool has real-world consequences. Confirm ambiguous contact matches, group chat IDs, recipient phone numbers, message body, and whether the message will use iMessage, SMS, or RCS before sending. Do not run network-exposed proxy setups without authentication and tight binding.

Duplicate Notes

Existing catalog entries cover WhatsApp, Telegram, LINE, and general messaging workflows. This entry covers the separate carterlasalle/mac_messages_mcp project and mac-messages-mcp package for local macOS Messages database access, attachment retrieval, contact lookup, and outbound Messages app sends.

• Source repositorygithub.com 2026-07-21T07:17:01+00:00
• Documentationraw.githubusercontent.com
• Submitted by oktofeesh12026-06-06