imessage-mcp

imessage-mcp

Pesquise e leia seu histórico de Mensagens a partir do Claude, Codex, Cursor, VS Code e qualquer outro cliente MCP.

Somente leitura. Roda no seu Mac. Sem contas, sem serviço em nuvem, nada para compilar.

• Encontra mensagens por palavras, texto exato ou frase em iMessage, SMS, MMS e RCS
• Lê conversas inteiras com edições, mensagens não enviadas, reações, respostas e recibos de leitura
• Mostra fotos que as pessoas enviaram, com dados de localização removidos
• Acompanha novas mensagens por meio de um feed de alterações e responde perguntas sobre contagens e tempo de resposta

Instalação

Requisitos: macOS 14 ou mais recente. Node.js 24.16 ou mais recente para instalações via npx (o Claude Desktop traz o seu próprio).

Configuração padrão, para qualquer cliente que leia JSON de mcpServers:

{
  "mcpServers": {
    "imessage": {
      "command": "npx",
      "args": ["-y", "imessage-mcp@latest"]
    }
  }
}

Em seguida, dê ao aplicativo que o executa Acesso Total ao Disco: Ajustes do Sistema > Privacidade e Segurança > Acesso Total ao Disco, ative o aplicativo (Claude, seu terminal, Cursor, VS Code, ...), depois saia completamente e reabra. Não sabe qual aplicativo? Execute npx -y imessage-mcp@latest doctor no terminal desse aplicativo e ele informará. Até que o acesso seja concedido, toda ferramenta responde com esses mesmos passos.

amp mcp add imessage -- npx -y imessage-mcp@latest

claude mcp add --scope user imessage -- npx -y imessage-mcp@latest

codex mcp add imessage -- npx -y imessage-mcp@latest

[mcp_servers.imessage]
command = "npx"
args = ["-y", "imessage-mcp@latest"]

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "imessage": { "type": "local", "command": ["npx", "-y", "imessage-mcp@latest"], "enabled": true }
  }
}

code --add-mcp '{"name":"imessage","command":"npx","args":["-y","imessage-mcp@latest"]}'

Se um aplicativo GUI informar que npx não foi encontrado, ele não consegue ver sua instalação do Node: use o caminho completo de which npx como command.

Como usar

Pergunte em palavras simples: "me atualize sobre minhas mensagens", "encontre a mensagem sobre a reserva do jantar", "quão rápido o Sam costuma responder?". Três prompts também estão no menu de prompts do seu cliente:

Clientes que anexam recursos podem usar imessage://conversations e imessage://conversations/{chat_id}.

Ferramentas

Toda ferramenta é somente leitura e marcada como readOnlyHint. Os resultados usam ids simples (message_id, chat_id, attachment_id) que você pode passar entre ferramentas.

Configuração

Adicione opções em args, por exemplo ["-y", "imessage-mcp@latest", "--privacy", "redacted"].

Privacidade e segurança

• Somente leitura. O servidor abre o banco de dados de Mensagens somente leitura e não tem ferramenta que envie, edite, reaja ou marque algo como lido.
• Local. Sem contas, telemetria ou análises. A única solicitação de rede é uma verificação opcional de versão no registro npm.
• Seu cliente vê o que você pede. Os resultados vão para o cliente MCP que você usa e seu provedor de modelo, sob suas políticas. --privacy redacted ou aggregate limita o que sai do servidor.
• Índice de pesquisa. Construído no seu Mac e armazenado em cache criptografado em ~/Library/Caches/imessage-mcp, com uma chave derivada do seu banco de dados de Mensagens, então abre apenas para um aplicativo que já pode ler suas mensagens. Excluí-lo é sempre seguro.
• Conteúdo não confiável. Mensagens podem conter texto escrito para manipular uma IA. O servidor informa aos clientes para tratar todo conteúdo de mensagem como dados, nunca como instruções.

Detalhes: SECURITY.md e PRIVACY.md.

Desenvolvimento

npm ci
npm test      # unit tests on synthetic Messages databases
npm run e2e   # launches the built server over stdio and HTTP
npm run perf  # one-million-message performance gates

Os testes usam apenas dados sintéticos. Veja CONTRIBUTING.md.

Licença

MIT