MCP.Market

macOS-only MCP server that exposes iMessage chat

by adelaidasofia·io.github.adelaidasofia/imessage-mcp·v0.1.0·2 stars
No reviews yet

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

A88/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A88/100

full report

Adoption
New

2 stars

Reviews

Write one

Nobody has reviewed macOS-only MCP server that exposes iMessage chat yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

macOS-only MCP server that exposes iMessage chat tools

No tool declarations could be read from the package source. They show once the server is installed.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • –Code scanpackage could not be scannedn/a
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 5 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 88/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How macOS-only MCP server that exposes iMessage chat compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
88/100
higher than 75% of 48,273 servers
GitHub stars
2
more than 75% of 28,534 servers

Install macOS-only MCP server that exposes iMessage chat in Claude Code, Cursor or VS Code

The registry entry has no remote endpoint or installable package.

What the publisher says

From the macOS-only MCP server that exposes iMessage chat repository's README, as published. We do not edit it. Read it on GitHub

imessage-mcp

<!-- mycelium-badges:start -->

<!-- mycelium-badges:end -->

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/.md and 🤖 AI Chats/iMessage/Groups/.md.
  • Send pathway via AppleScript with draft+confirm pattern (no auto-send).

Tool surface

Read: healthcheck, listchats, listmessages, getchat, searchcontacts, searchmessages, getmessagecontext, getunread, getthread, listattachments, markchatread, exporttovault.

Write: sendmessage (drafts an AppleScript send), confirmsend (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

---
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.

Related MCPs

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

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

macOS-only MCP server that exposes iMessage chat: common questions

Is macOS-only MCP server that exposes iMessage chat safe?
Yes, by our scan: it is graded A (88/100). Read the macOS-only MCP server that exposes iMessage chat safety report
Does macOS-only MCP server that exposes iMessage chat need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is macOS-only MCP server that exposes iMessage chat maintained?
The last commit was 41 days ago (2026-09-22). The latest release is v0.1.0.
How does macOS-only MCP server that exposes iMessage chat compare with other MCP servers?
safety score 88/100 (higher than 75% of 48,273 servers); github stars 2 (more than 75% of 28,534 servers). Full comparison.

More from adelaidasofia →