Imessage Max MCP Server
An MCP (Model Context Protocol) server for iMessage. It lets AI agents read, search, and send your messages, resolving phone numbers to contact names along the way. Its 10 documented tools cover chat, messages. It runs locally over stdio via the published package.
People who work with chat and messages and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Swift.
VERIFIED ACTIVE
LAST COMMIT 2026-09-03 · ★ 6 · #58 OF 105 MAINTAINED COMMUNICATION · VERIFIED 2026-09-18
MIT · Swift · how we verify → /methodology
01 · Install Imessage Max
Claude Code
claude mcp add cyberpapiii-imessage-max -- uvx imessage-maxClaude Desktop / Cursor / VS Code - add to config
{
"mcpServers": {
"cyberpapiii-imessage-max": {
"command": "uvx",
"args": [
"imessage-max"
]
}
}
}Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.
Using another client? Same JSON, different key
Claude Desktop · mcpServers
Cursor · mcpServers
VS Code · servers
Windsurf · mcpServers
Zed · context_servers
Cline · mcpServers
Roo Code · mcpServers
Continue · mcpServers
LibreChat · mcpServers
Gemini CLI · mcpServers
Codex CLI · mcp_servers
Full setup guides: every client.
02 · Evidence
Security posture
What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.
runs as local process (stdio) - runs on your machine with your user's permissions
license MIT - declared in the repository
pypi package imessage-max - check the name against the project README before installing (PyPI has no namespace ownership)
registry namespace io.github.cyberpapiii is GitHub-verified and matches the repo owner
03 · What Imessage Max can do
Prose above is summarized from the project's README and registry record - no invented capabilities.
What you can build
With this server connected, an agent can find chats by participants, name, or recent content, inspect a known thread without opening the full conversation, retrieve messages with flexible filtering. Returns metadata for media. Explicit chat_id lookups are never filtered, and retrieve image content by attachment ID with resolution variants.
Capability map
Tools grouped from the project's README - what Imessage Max lets an agent do.
read & search
6 tools - e.g. Retrieve image content by attachment ID with resolution variants.; Browse recent chats with previews.; Get messages surrounding a specific message.
get_attachment · list_chats · get_context · get_active_conversations · list_attachments · get_unread
Chat
2 tools - e.g. Find chats by participants, name, or recent content.; Inspect a known thread without opening the full conversation.
find_chat · get_chat_details
Messages
2 tools - e.g. Retrieve messages with flexible filtering. Returns metadata for media. Explicit chat_id lookups are never filtered.; New messages across all chats after a ROWID cursor, in arrival order. Pass the returned…
get_messages · get_messages_since
Latest releases
v1.7.1 · 2026-09-03
imessage-max-macos.tar.gz sha256: dfe6bd908dd6ddb3f414d244c4c3f83779ba6e7f1ea977efa7fc545b62043414
v1.7.0 · 2026-09-02
imessage-max-macos.tar.gz sha256: 6b803b5a83c9f011e08f14ce6b0e3be6e9b5bd8204dcda463375cdf93602abab
v1.6.0 · 2026-09-02
imessage-max-macos.tar.gz sha256: b528be6ebdcd85a9c38557c551e87951ef7953ea87c98f96c933423810832199
04 · Who maintains Imessage Max
imessage-max is maintained by cyberpapiii. It's the only MCP server we track from this author; the repo dates to Jan 2026.
05 · Facts
- repository
- github.com/cyberpapiii/imessage-max
- category
- communication - ranked #58 of 105 actively-maintained communication servers as of 2026-09-18.
- release cadence
- 6 releases in the last 90 days (latest 2026-09-03)
- registry
- io.github.cyberpapiii/imessage-max (active, first published 2026-01-17 · 16 versions)
- packages
- pypi:imessage-max
06 · Imessage Max FAQ
Is Imessage Max still maintained?
Yes - as of 2026-09-18, its last commit was 2026-09-03 and it shipped 6 releases in the last 90 days. We re-verify nightly.
What can Imessage Max do?
With this server connected, an agent can find chats by participants, name, or recent content, inspect a known thread without opening the full conversation, retrieve messages with flexible filtering. Returns metadata for media. Explicit chat_id lookups are never filtered, and retrieve image content by attachment ID with resolution variants.
How do I install Imessage Max?
Run `uvx imessage-max`. You can also paste the ready-made client config above.
Does Imessage Max run locally?
Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.
07 · Alternatives to Imessage Max
Alternatives to Imessage Max
Maintained communication servers if Imessage Max isn't the fit.
- Draw Io Create diagrams in chat, rendered as live interactive draw.io diagrams. 10,000+ searchable shapes. ★ 5,462 · 2026-09-18
- Mockserver Mock, record/replay, verify and chaos-test any HTTP, REST, gRPC or LLM dependency over MCP. ★ 4,972 · 2026-09-17
- Vexa Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled. ★ 2,798 · 2026-09-17
- Agent Swarm Full Agent Swarm API and MCP server with local SQLite storage for multi-agent orchestration. ★ 806 · 2026-09-18
- Evolution API MCP server for Evolution API - WhatsApp messaging, instances, contacts ★ 271 · 2026-08-29
- Agenticmail MCP Server Real email and SMS for AI agents - send mail, receive verification codes, drive a real inbox. ★ 223 · 2026-09-13
Pairs well with
Servers that cover what Imessage Max doesn't - only shown when the pairing reason fits the companion.
More communication MCP servers · Cobroya · Figmanage · Ethora MCP Server · Entra News Podcast · Iterable Data