Imessage Max
A native Swift server that hooks into macOS Messages and Contacts databases to give Claude read and send access to your iMessage history. Instead of raw SQL queries, you get 11 intent-aligned tools like find_chat, search, and get_messages with automatic contact resolution and session grouping. The attachment handling is smart: images come back as vision, thumb, or full variants to control token cost, and you can see what's local versus offloaded to iCloud before fetching. Useful when you need Claude to search conversations, pull context around specific messages, or send replies to exact threads after confirming recipients. Requires Full Disk Access for chat.db and Contacts permission for name resolution.
- GitHub stars
- 2
- tools
- 13
- transport
- STDIO
- last updated
- Jan 19, 2026
Tools
13 toolsPublic tool metadata for what this MCP can expose to an agent.
find_chatFind chats by participants, name, or recent content.
Find chats by participants, name, or recent content.
No parameter schema in public metadata yet.
get_chat_detailsInspect a known thread without opening the full conversation.
Inspect a known thread without opening the full conversation.
No parameter schema in public metadata yet.
get_messagesRetrieve messages with flexible filtering. Returns metadata for media.
Retrieve messages with flexible filtering. Returns metadata for media.
No parameter schema in public metadata yet.
get_messages_sinceNew messages across all chats after a ROWID cursor, in arrival order.
New messages across all chats after a ROWID cursor, in arrival order.
No parameter schema in public metadata yet.
get_attachmentRetrieve image content by attachment ID with resolution variants.
Retrieve image content by attachment ID with resolution variants.
No parameter schema in public metadata yet.
list_chatsBrowse recent chats with previews.
Browse recent chats with previews.
No parameter schema in public metadata yet.
searchFull-text search across messages.
Full-text search across messages.
No parameter schema in public metadata yet.
get_contextGet messages surrounding a specific message.
Get messages surrounding a specific message.
No parameter schema in public metadata yet.
get_active_conversationsFind chats with recent back-and-forth activity.
Find chats with recent back-and-forth activity.
No parameter schema in public metadata yet.
list_attachmentsBrowse shared items grouped by message. Each row includes exact attachment ids for follow-up fetches.
Browse shared items grouped by message. Each row includes exact attachment ids for follow-up fetches.
No parameter schema in public metadata yet.
get_unreadGet unread threads or unread messages. Default is summary by chat.
Get unread threads or unread messages. Default is summary by chat.
No parameter schema in public metadata yet.
sendSend a message or file attachment (requires Automation permission for Messages.app).
Send a message or file attachment (requires Automation permission for Messages.app).
No parameter schema in public metadata yet.
diagnoseTroubleshoot configuration and permission issues.
Troubleshoot configuration and permission issues.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
iMessage Max
iMessage Max
For a Mac app to set it up and manage it, use the native menu bar companion. It checks setup, manages the local service, and copies the connection details your assistant needs.
iMessage Max is an MCP (Model Context Protocol) server for iMessage. AI agents use it to read, search, and send your messages. It resolves phone numbers to contact names.
It is written in Swift and ships as one Mac app with no runtime dependencies.
Distribution
There is one Swift implementation, in swift/. It ships as:
iMessage Max.appin a notarized DMG on GitHub releases (Apple silicon, macOS 15 or later)- a Homebrew cask (
cyberpapiii/tap/imessage-max) that installs the same app - a Claude Desktop extension (
iMessage-Max-<version>.mcpb) on GitHub releases - source builds (swift/README.md)
- Codex plugin metadata (
.codex-plugin/) - Claude Desktop MCPB metadata (
mcpb/)
Features
Details
- Repository
- github.com/cyberpapiii/imessage-max
- Category
- Search & Web Crawling
- Package
imessage-max- Transport
- STDIO
- Registry
- MCP registry, active
Related Search & Web Crawling MCP servers
View all
Clishopdavooxbv2/clishopOrder anything from your terminal — search, buy, track, and manage via MCP tools.2stars
Quora MCP Server and API by Cotletcotletdev/quora-api-mcp-serverQuora questions and answers community MCP server: search questions, post answer, list my answers.0stars
LynxPromptgeiserx/lynxprompt-mcpSearch, read and manage AI agent instruction blueprints (AGENTS.md, CLAUDE.md) on LynxPrompt2stars
Dnd Oraclegregario/dnd-oracleD&D 5e SRD MCP server with monster, spell, equipment search and encounter building tools2stars
Priorcg3-llc/prior_mcpShared knowledge base for AI agents. Search and contribute solutions to technical problems.2stars
Clirankalexanderclapp/clirank-mcp-serverSearch, compare, and get docs for 210+ APIs ranked by CLI and agent relevance.2stars