How do I connect Mac Messages MCP Server to Claude?

Run `claude mcp add mac-messages-mcp -- uvx --version` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.

Is Mac Messages MCP Server free?

The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.

What can Mac Messages MCP Server do?

Mac Messages MCP Server documents 11 tools to the agent, including tool_check_addressbook, tool_check_contacts, tool_check_db_access. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.

Mac Messages MCP

Unclaimed

by carterlasalle

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.

Set up this server

Compare servers My Stack

01 / Choose your client

02 / Before you connect

Authentication is not specified. Check the project instructions before connecting.

Install the runtime required by the project and make it available to your client.

Project instructionsEnvironment variable names (optional)

Use names from the project instructions, separated by commas. Enter names only, never secret values.

03 / Add the configuration

Source: generated from public install instructions

claude mcp add --transport stdio 'mac-messages-mcp' -- 'uvx' '--version'

Run in your terminal after replacing any placeholders.

04 / Check it in your client

Open your client’s MCP settings and confirm the server connects and lists its tools. A copied configuration does not confirm a working connection.

applescriptclaudecontactscursorimessagemacmacosmcpmcp-server

Is this your MCP server?

This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.

Claim this server

Security profile

Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works

11 of 11 tools

Documented tools (11)

From project documentation. A server handshake does not verify each tool’s description or behavior.

tool_check_addressbook

Diagnose Contacts/AddressBook database access

tool_check_contacts

Return a contact count and a small sample

tool_check_db_access

Diagnose access to ~/Library/Messages/chat.db

tool_check_imessage_availability

Check likely iMessage availability for a phone number or email

tool_find_contact

Fuzzy-match a name in Contacts and return phone numbers

tool_fuzzy_search_messages

Search message bodies by approximate text match; defaults to 30 days, or use hours=0 for all history

tool_get_attachment

Fetch one attachment by ID, inline when supported or as a local path

tool_get_chats

List named group chats and their identifiers

tool_get_recent_messages

Read recent messages, optionally filtered by contact or group chat ID

tool_search_attachments

Find attachment metadata by date, contact, MIME type, and limit

tool_send_message

Send one direct or group message through Messages.app

Tool change history

Compared across complete checks of the same configuration. Tools were listed, not invoked. Input-schema changes are not measured here.

No complete tool checks yet.

FAQ

Questions about Mac Messages MCP Server

How do I connect Mac Messages MCP Server to Claude?: Run `claude mcp add mac-messages-mcp -- uvx --version` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.
Is Mac Messages MCP Server free?: The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
What can Mac Messages MCP Server do?: Mac Messages MCP Server documents 11 tools to the agent, including tool_check_addressbook, tool_check_contacts, tool_check_db_access. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.