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

Chalk Labs

Need help deploying macOS-only MCP server that exposes iMessage chat?

Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.

Book a call

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…

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 (9 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
License
MIT
First seen
Oct 24, 2026
Last checked
Oct 25, 2026

More from adelaidasofia

Done for you

Rather not set it up yourself?

Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.

See how we build AI agents →Read the case studies

Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.

launches shipped
50+
launches shipped
media placements
500+
media placements
founders on every account
2
founders on every account

Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block

Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.

Get macOS-only MCP server that exposes iMessage chat running in your business

Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.

Goes to the Chalk Labs founders, not the newsletter. Privacy

Need help deploying macOS-only MCP server that exposes iMessage chat?

CallGet help
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)