Messages
Let Claude Code or Cursor search and browse your Mac iMessage history without leaving the agent.
Overview
io.github.cardmagic/messages is a MCP server for the Build phase that fuzzy-searches and browses Apple Messages/iMessage for agent and CLI workflows on macOS.
What is this MCP server?
- Fuzzy search across Apple Messages and iMessage threads from MCP tools or CLI
- stdio MCP server published as @cardmagic/messages on npm (v1.2.0)
- Local-first access to personal message history for support replies and research context
- Dual surface: same project usable as CLI or MCP for agent workflows
- No remote OAuth—runs on your Mac against the Messages database
- Server version 1.2.0 per MCP registry schema
- npm package identifier @cardmagic/messages with stdio transport
- GitHub repository https://github.com/cardmagic/messages
Community signal: 18 GitHub stars.
What problem does it solve?
Your agent cannot see iMessage context, so you waste time manually hunting threads when answering users or writing copy.
Who is it for?
Mac-based solo builders who want private, local iMessage recall inside Claude Code or Cursor while shipping support-heavy products.
Skip if: Windows/Linux developers, teams needing shared Slack/email inboxes, or anyone who cannot run local Apple Messages access.
What do I get? / Deliverables
After you register the stdio server, your agent can query and browse your Messages history with fuzzy search tools during the same session.
- Registered stdio MCP server exposing fuzzy search and browse tools over iMessage
- CLI-capable workflow for the same search without opening Messages.app
- Agent-grounded replies citing actual message thread content
Recommended MCP Servers
Journey fit
Canonical shelf is Build because you wire a local MCP stdio server into your coding agent as an integration, not because messaging is only useful while coding. Integrations is the right subphase: npm stdio transport and fuzzy search tools expose Apple Messages as agent-callable context.
How it compares
Local Communication MCP integration, not a cloud team-chat SaaS or a generic markdown notes skill.
Common Questions / FAQ
Who is io.github.cardmagic/messages for?
Solo builders on macOS who use MCP-enabled coding agents and want searchable iMessage context without manual exports.
When should I use io.github.cardmagic/messages?
Use it during Build when wiring agent integrations—especially for customer support drafts, personal research, or verifying what was promised in a text thread.
How do I add io.github.cardmagic/messages to my agent?
Install @cardmagic/messages from npm, configure stdio MCP in Claude Code or Cursor pointing at that package, then grant macOS access to Messages as required by the host.