imessage-mcp
imessage-mcp is an MCP server. Its repository has 27 GitHub stars and is licensed under MIT; we last read it on 2026-10-22.
Search and read your Messages history across various MCP clients including Claude, Codex, Cursor, and VS Code.
Install
MCP servers are packaged differently from each other -- some run via npx, some as a Docker image, some as a plain script you clone and run. imessage-mcp’s own README did not state one plainly enough for this page to quote it rather than guess, so it will not guess. The repository below states it.
What it reaches, and what it needs
What it connects to
Unverified means a mention in the server’s own description, not a citation. A wrong claim here costs nothing to correct and nothing to trust yet.
Maintenance
Search and read your Messages history from Claude, Codex, Cursor, VS Code, and any other MCP client.
What imessage-mcp can do
8 tools documented in its README. An AI client calls these by name.
search_messages- Search by substring, exact text, token, or phrase. Message text by default; conversation names and attachment filenames are opt-in. Filter by service, sent or received, and date
get_conversation- Read a conversation by `chat_id` or by a contact or group name, with edits, reactions, receipts, replies, group events, and attachments. The cursor pages to older events
list_conversations- Find conversations by contact, service, kind, reply state, or date, each with its latest message, newest first or by who you text most
get_attachment- Show one attachment from `get_conversation`: images as a JPEG with location and camera metadata removed, text files as text. Needs the `full` privacy mode
sync_messages- Pull every change since a cursor: new, edited, unsent, and deleted messages, conversation memberships, reactions, and receipts
analyze_communication- Message counts by hour and weekday, response times, streaks, and who starts conversations
resolve_contact- Match a name, phone number, or email to a contact in your Mac's Address Book, and report ambiguity rather than guess
server_status- Version, update availability, privacy mode, index and cache state, schema support, conversation membership counts, and Contacts access
Read from the README; names are kept only if the README contains them.
Common questions about imessage-mcp
- What does imessage-mcp do?
- Search and read your Messages history across various MCP clients including Claude, Codex, Cursor, and VS Code.
- How do I install imessage-mcp?
- Its README did not state an install command plainly enough for us to quote one, so we do not guess. The repository has the instructions: https://github.com/anipotts/imessage-mcp
- Which AI clients can use imessage-mcp?
- Its own description mentions Cursor and VS Code. That is a mention in its description, not a test we ran.
- Is imessage-mcp official and is it maintained?
- We found nothing naming it as a vendor’s official server. Its repository has 27 GitHub stars and its state in our directory is listed. Its last commit we recorded was on 2026-10-20.
- What licence does imessage-mcp use?
- The repository declares the MIT licence.