Skip to content
Agentmart
Submit a tool

macOS-only MCP server that exposes iMessage chat

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

Connector by adelaidasofia · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 2
Write a review

Install

Works with Claude Desktop. Read the repository before you give any tool access to your data.

Download the bundle

MCP bundle (.mcpb): open it with Claude Desktop.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

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

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
10 read · 3 write · 0 delete · 1 not yet classified
Secrets
None asked for
Install scripts
None found
Runs as
Downloaded binary

Tools by what they do 14

Read from the source code; the running server may list different tools.

Read 10 · Look things up without changing anything.

  • get_chat
  • get_message_context
  • get_thread
  • get_unread
  • healthcheck
  • list_attachments
  • list_chats
  • list_messages
  • search_contacts
  • search_messages

Write 3 · Create, change, send or run things.

  • confirm_send
  • mark_chat_read
  • send_message

Not yet classified 1 · We could not tell from the name and description.

  • export_to_vault

Network hosts it talks to 3

  • code.claude.com · found in code
  • github.com · found in install command, code
  • myceliumai.co · found in code

Files it touches

  • ~/.claude/imessage-mcp/search.db
  • ~/.claude/imessage-mcp/transcripts.db
  • /opt/homebrew/bin/whisper-cli
  • Your home directory (~)

Tools (14)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • confirm_send

    Commit a previously-drafted send. Runs the AppleScript and returns success.

  • export_to_vault

    Walk every chat meeting the threshold and write per-chat Markdown to the vault. Idempotent: skips chats whose vault frontmatter `last_message_ts` already covers the latest message in chat.db. Pass force=True to rewrite all.

  • get_chat

    Return one chat's metadata + participants by ROWID or guid.

  • get_message_context

    Return messages surrounding a given ROWID in the same chat.

  • get_thread

    Return every message in a reply thread.

  • get_unread

    Return unread inbound messages across all chats (newest first).

  • healthcheck

    Return FDA + chat.db reachability + Whisper status + search index status.

  • list_attachments

    List attachments, filterable by chat or recency.

  • list_chats

    List chats sorted by most recent activity. Adds resolved display names.

  • list_messages

    Pull recent messages for one chat, scrubbed and (optionally) CRM-enriched.

  • mark_chat_read

    Mark a chat read via Messages.app AppleScript (low-consequence, no draft).

  • search_contacts

    Find handles by substring; enriches with Contacts.app names + CRM context.

  • search_messages

    FTS5 full-text search over messages. Refreshes the index by default.

  • send_message

    Stage an iMessage (or SMS) send. Returns a draft_id; nothing is sent yet. Args: recipient: phone (E.164 with leading +) or email handle text: message body service: "iMessage" or "SMS" (SMS requires Continuity to your iPhone)

Signals

Stars
2
Forks
2
Open issues
1
Last commit
Oct 22, 2026 (7 days ago)
Last release
May 20, 2026 (5 months ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name
io.github.adelaidasofia/imessage-mcp
Version
0.1.0
Auth
No auth
Packages
mcpb https://github.com/adelaidasofia/imessage-mcp/releases/download/v0.1.0/imessage-mcp.mcpb
License
MIT
Repository
github.com/adelaidasofia/imessage-mcp
First seen
Oct 24, 2026
Last checked
Oct 25, 2026
Source
Official MCP Registrygithub-graphql

More from adelaidasofia

Cite this page

macOS-only MCP server that exposes iMessage chat. Agent Mart. https://agentmart.dev/connectors/adelaidasofia-imessage-mcp (last updated 2026-10-25)