convez.ai
MCP ServerIntegração & APIsAvançado
adelaidasofia

iMessage MCP Server

adelaidasofia/imessage-mcp

Integre iMessage ao Claude com busca, transcrição e sync automático

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que expõe o histórico de iMessage do macOS ao Claude, com leitura direta do banco de dados, transcrição de notas de voz via Whisper, busca FTS5 e envio via AppleScript com confirmação prévia. Exporta automaticamente conversas para um vault Obsidian organizado por contato.

Instalação

$npx convez-ai adelaidasofia/imessage-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
2
Acompanhando
0
Saúde
42%
Último commit
há 1 dia
Versão
v0.1.0
Issues abertas
4
Contribuidores
3

Casos de uso

  • Acessar histórico completo de iMessage dentro do Claude para análise contextual
  • Transcrever automaticamente mensagens de voz usando Whisper local
  • Pesquisar mensagens com FTS5 indexação incremental
  • Sincronizar conversas em vault Obsidian de forma automática
  • Enviar mensagens via AppleScript com padrão de rascunho+confirmação

Veredito

MCP robusto e bem arquitetado, exclusivo para macOS, que oferece integração profunda com iMessage mantendo padrões de segurança (leitura imutável, confirmação antes de envio). Ideal para quem precisa levar histórico de mensagens para dentro do fluxo de trabalho com Claude.

README

A tradução para o português deste README ainda está na fila.

imessage-mcp

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.

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):

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.

Ver o original no GitHub

Bom para

Relacionados