Listed from the MCP registry; nobody on Odel publishes it.

MCP server: One MCP server.

macOS-only MCP server that exposes iMessage chat

@adelaidasofiaMCP server · External

macOS-only MCP server that exposes iMessage chat.db to Claude and exports per-chat history to an…

Messaging appsv0.1.0MITPython
Freeno charge per call

Runs on your machine from its package; the steps are below.

What it does

  1. Reads
  2. Writes
  3. High impact

At most: moves money, runs code or commands, deletes data, or sends messages for you.

What it costs

Free

Odel charges nothing per call. The publisher may charge for its own service.

Runs locally over stdio

This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).

MCP Bundlehttps://github.com/adelaidasofia/imessage-mcp/releases/download/v0.1.0/imessage-mcp.mcpbv0.1.0

Distributed as an MCP bundle (`https://github.com/adelaidasofia/imessage-mcp/releases/download/v0.1.0/imessage-mcp.mcpb`) — download it and import the bundle in your MCP client.

README2 min read

imessage-mcp

License GitHub stars Last commit Open issues PyPI version PyPI downloads Built by Mycelium AI

macOS-only MCP server that exposes iMessage history to Claude and exports per-chat conversations into an Obsidian vault. Mirrors the whatsapp-mcp pattern: same hook, same launchd cadence, same vault shape.

Architecture

  • Direct read of ~/Library/Messages/chat.db (SQLite, opened mode=ro&immutable=1). No bridge daemon.
  • Voice-note transcription via Whisper local-cpp (reuses the model already installed for whatsapp-mcp).
  • FTS5 incremental search index at ~/.claude/imessage-mcp/search.db.
  • Vault export per chat into 🤖 AI Chats/iMessage/<Contact>.md and 🤖 AI Chats/iMessage/Groups/<Group>.md.
  • Send pathway via AppleScript with draft+confirm pattern (no auto-send).

Tool surface

Read: healthcheck, list_chats, list_messages, get_chat, search_contacts, search_messages, get_message_context, get_unread, get_thread, list_attachments, mark_chat_read, export_to_vault.

Write: send_message (drafts an AppleScript send), confirm_send (commits).

Install

Open Claude Code, paste:

/plugin marketplace add adelaidasofia/imessage-mcp
/plugin install imessage-mcp@imessage-mcp

Then grant Full Disk Access to Claude.app (required for chat.db read) and restart Claude Code. Full setup details and env vars in SETUP.md.

Legacy install (manual .mcp.json registration)

See SETUP.md. The short version: grant Full Disk Access to Claude.app, run uv sync, register in vault .mcp.json, restart Claude Code.

Vault export shape

yaml
---
type: imessage-chat
contact: "Jane Doe"
phone: "+15555550123"
service: iMessage
chat_guid: "iMessage;-;+15555550123"
message_count: 412
first_message: 2024-08-12
last_message: 2026-05-06
last_sync: 2026-05-07
---

Body sections per date with reactions, edits, replies, voice-note transcripts, and attachment wikilinks.

Same author, same architecture pattern (FastMCP, draft+confirm on writes where applicable, vault auto-export, MIT):

Telemetry

This plugin sends a single anonymous install signal to myceliumai.co the first time it loads in a Claude Code session on a given machine.

What is sent:

  • Plugin name (e.g. slack-mcp)
  • Plugin version (e.g. 0.1.0)

What is NOT sent:

  • No user identifiers, names, emails, tokens, or API keys
  • No file paths, message content, or anything from your work
  • No IP address is stored after dedup processing

Why: Helps the maintainer know which plugins people actually install, so attention goes to the ones that get used.

Opt out: Set the environment variable MYCELIUM_NO_PING=1 before launching Claude Code. The hook will skip the network call entirely. Already-pinged installs leave a sentinel at ~/.mycelium/onboarded-<plugin> — delete it if you want to reset state.

License

MIT.


Built by Adelaida Diaz-Roa. Full install or team version at diazroa.com.

Similar modules

Browse Messaging apps