Messages
Gives Claude direct access to your macOS iMessage and SMS history through the Messages database. Exposes six MCP tools: search with fuzzy matching and typo tolerance, browse recent messages, list contacts by activity, view full conversation threads, and get message statistics. The indexing happens automatically using SQLite FTS5 and MiniSearch, so the first search builds the index and subsequent queries are fast. Needs Full Disk Access permission to read chat.db. Reach for this when you want Claude to search your message history, find what someone said about a topic, or pull up conversation context without opening Messages.app.
- GitHub stars
- 18
- tools
- 6
- transport
- STDIO
- last updated
- Jan 1, 2026
Tools
6 toolsPublic tool metadata for what this MCP can expose to an agent.
search_messagesSearch messages with fuzzy matching
Search messages with fuzzy matching
No parameter schema in public metadata yet.
recent_messagesGet most recent messages
Get most recent messages
No parameter schema in public metadata yet.
list_contactsList contacts by activity
List contacts by activity
No parameter schema in public metadata yet.
list_conversationsList conversations with counts
List conversations with counts
No parameter schema in public metadata yet.
get_threadGet conversation thread with a contact
Get conversation thread with a contact
No parameter schema in public metadata yet.
get_message_statsGet index statistics
Get index statistics
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
messages
Fuzzy search and browse Apple Messages (iMessage/SMS) from the command line, as a Claude Code plugin, or as an MCP server.
Features
- Fuzzy search with typo tolerance across all your messages
- Browse recent messages, contacts, and conversations
- Contact resolution - shows names instead of phone numbers
- Context display - see messages before/after each match
- Filter by sender or date range
- Auto-indexing - index automatically rebuilds when new messages are detected
- Multiple interfaces - CLI, MCP server, or Claude Code plugin
Requirements
- macOS (reads from Apple Messages database)
- Node.js 22+
- Full Disk Access permission for your terminal (to read
~/Library/Messages/chat.db)
Installation
Homebrew
brew install cardmagic/tap/messages
npm
npm install -g @cardmagic/messages
Claude Code Plugin (recommended)
Install as a plugin to get skills (auto-invoked) and slash commands:
# Add the marketplace
claude plugin marketplace add cardmagic/ai-marketplace
# Install the plugin
claude plugin install messages@cardmagic
Details
- Repository
- github.com/cardmagic/messages
- Category
- Search & Web Crawling
- Package
@cardmagic/messages- Transport
- STDIO
- Registry
- MCP registry, active
Related Search & Web Crawling MCP servers
View all
Google Trends MCPtrendsmcp-ai/google-trends-mcpGoogle Trends: Search, Images, News, Shopping over time, growth metrics. Free key at trendsmcp.ai17stars
Docdexbekirdag/docdexFast per-repo documentation indexer and full-text search MCP server for codebases.16stars
Mathlasarcherkattri/mathlasAirtight math for AI agents: 3.68M-doc theorem search + numeric/Lean verification. No LLM, no key.12stars
Eur Lex Mcp Servercyanheads/eur-lex-mcp-serverSearch EU legislation, CJEU case law, and treaties; traverse CELLAR graph; browse EuroVoc concepts.12stars
Cortexdanielblomma/cortexLocal repo context for coding assistants with semantic search and graph relationships.12stars
OpenGrok MCP Servericyhot09/opengrok-mcp-serverMCP server bridging OpenGrok search engine with AI for instant context across massive codebases.11stars