Imessage Max MCP Server - install, status & alternatives [2026]

01 · Install Imessage Max

Claude Code

claude mcp add cyberpapiii-imessage-max -- uvx imessage-max

Claude 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, and retrieve image content by attachment ID with resolution variants.

The 9 tools it gives your agent

Extracted from the project's README - what imessage-max lets an agent do.

find_chat: - Find chats by participants, name, or recent content.
get_chat_details: - Inspect a known thread without opening the full conversation.
get_messages: - Retrieve messages with flexible filtering. Returns metadata for media.
get_attachment: - Retrieve image content by attachment ID with resolution variants.
list_chats: - Browse recent chats with previews.
get_context: - Get messages surrounding a specific message.
get_active_conversations: - Find chats with recent back-and-forth activity.
list_attachments: - Browse shared items grouped by message. Each row includes exact attachment ids for follow-up fetches.
get_unread: - Get unread threads or unread messages. Default is summary by chat.

Latest releases

v1.4.1 · 2026-08-07

Patch release. · Fixed · AppleScript writes its error text with the typographic apostrophe, so can't get chat, can't get participant, and doesn't understand never matched the straight-form checks in the osascript…

v1.4.0 · 2026-08-07

Dual-era MCP (2026-07-28 stateless lane alongside legacy sessions) plus 21 improvement plans. · Client-visible changes: · New send statuses: failed_delivery (chat.db recorded a delivery error - the message was NOT…

v1.2.1 · 2026-03-13

comprehensive audit improvements - security, bugs, dedup, spec compliance · New Contributors · @cyberpapiii made their first contribution in

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 #59 of 99 actively-maintained communication servers as of 2026-08-25.
release cadence: 2 releases in the last 90 days (latest 2026-08-07)
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-08-25, its last commit was 2026-08-08 and it shipped 2 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, 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.

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 CLI · Entra News Podcast · Iterable Data