mac_messages_mcp MCP Server
carterlasalle/mac_messages_mcp
[](https://agentrank-ai.com/tool/carterlasalle--mac_messages_mcp/?utm_source=badge&utm_medium=readme&utm_campaign=agentrank_badge) An MCP server that securely interfaces with your iMessage database via the Model Context Protocol (MCP), allowing LLMs to query and analyze iMessage conversations. It includes robust phone number validation, attachment processing, contact management, group chat handling, and full support for sending and receiving messages.
claude mcp add agentrank -- npx -y agentrank-mcp-server Overview
carterlasalle/mac_messages_mcp is a Python MCP server licensed under MIT. An MCP server that securely interfaces with your iMessage database via the Model Context Protocol (MCP), allowing LLMs to query and analyze iMessage conversations. It includes robust phone number validation, attachment processing, contact management, group chat handling, and full support for sending and receiving messages. Topics: applescript, claude, contacts, cursor, imessage, mac, macos, mcp, mcp-server.
Ranked #234 out of 24846 indexed tools.
In the top 1% of all indexed tools.
Has 20 contributors.
Ecosystem
Score Breakdown
331 stars → growing community
Last commit 20d ago → recently updated
15/15 issues closed → responsive maintainer
20 contributors → active community
No dependents → no downstream usage
332 weekly installs → early adoption
Weights: Freshness 20% · Issue Health 20% · Dependents 22% · Stars 10% · Contributors 8% · How we score →
Matched Queries
From the README
# 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. 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 appearRead full README on GitHub →
Get the weekly AgentRank digest
Top movers, new tools, ecosystem insights — straight to your inbox.