How do I connect Imessage MCP Server to Claude?

Run `claude mcp add imessage-mcp -- npx -y imessage-mcp doctor` 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 Imessage 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 Imessage MCP Server do?

Imessage MCP Server documents 26 tools to the agent, including check_new_messages, contact_stats, conversation_gaps. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.

Imessage MCP

Unclaimed

by anipotts

Search and read your Messages history from Claude, Codex, Cursor, VS Code, and any other MCP client.

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 'imessage-mcp' -- 'npx' '-y' 'imessage-mcp' 'doctor'

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.

aianalyticsapple-messagesclaudecodexcursorimessagelocal-firstmacosmcpmcp-servermessage-historymmsmodel-context-protocolprivacyrcsread-onlysmssqlitetypescript

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

26 of 26 tools

Documented tools (26)

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

check_new_messages

Track new messages since your last check (baseline + delta)

contact_stats

Per-contact volumes, trends, and hourly patterns

conversation_gaps

Find the longest silences in a conversation

double_texts

Detect double-texting and unanswered message patterns

first_last_message

First and last message ever exchanged with a contact

forgotten_contacts

Contacts you've lost touch with

get_contact

Deep contact info with stats and yearly breakdown

get_conversation

Conversation thread with cursor-based pagination

get_edited_messages

Edited and unsent messages with timing

get_group_chat

Per-member stats and monthly activity timeline

get_message_effects

Slam, loud, confetti, fireworks analytics

get_reactions

Tapback distribution, top reactors, most-reacted messages

get_read_receipts

Read/delivery latency and unread patterns

get_thread

Reconstruct reply thread trees

help

Full tool guide with usage examples

list_attachments

Query attachments by contact, MIME type, and date range

list_contacts

All contacts with message counts and date ranges

list_group_chats

Group chats with member counts and activity

message_stats

Aggregate stats with time-series grouping

on_this_day

Messages from this date in past years

resolve_contact

Fuzzy-match a name, phone number, or email to a contact

search_messages

Full-text search with filters: query, contact, date range, direction, group chat, attachments

streaks

Consecutive-day messaging streaks

temporal_heatmap

7x24 activity heatmap (day-of-week by hour)

who_initiates

Who starts conversations? Initiation ratio per contact

yearly_wrapped

Spotify Wrapped for iMessage — full year summary

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 Imessage MCP Server

How do I connect Imessage MCP Server to Claude?: Run `claude mcp add imessage-mcp -- npx -y imessage-mcp doctor` 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 Imessage 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 Imessage MCP Server do?: Imessage MCP Server documents 26 tools to the agent, including check_new_messages, contact_stats, conversation_gaps. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.