Last updated
March 16, 2026
MCP profile
Github Cardmagic Messages
Fuzzy search and browse Apple Messages/iMessage from CLI or MCP server
Developer ToolsPackageJavaScript/TypeScriptOpen SourceExternal
Visibility
Public
ByRegistry
About This MCP Server
1. Auto-Indexing: On first search (or when new messages are detected), the tool automatically:
2. Searching: Queries both indexes for best results with typo tolerance
3. Storage: Index files are stored in ~/.messages/:
Capabilities
Fuzzy search with typo tolerance across all your messagesBrowse recent messages, contacts, and conversationsContact resolution - shows names instead of phone numbersContext display - see messages before/after each matchFilter by sender or date rangeAuto-indexing - index automatically rebuilds when new messages are detectedMultiple interfaces - CLI, MCP server, or Claude Code plugin
Why Use Github Cardmagic Messages?
- 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
Specifications
Status
live
Industry
Developer Tools
Category
General
Server type
Package
Language
JavaScript/TypeScript
License
Open Source
Verified
Yes
Requirements
- macOS (reads from Apple Messages database)
- Node.js 22+
- Full Disk Access permission for your terminal (to read ~/Library/Messages/chat.db)
Hosting
Hosting Options
- Package
API
Integrate this server into your application. Choose a connection method below.
1
Install
Install command
JavaScript/TypeScript
brew install cardmagic/tap/messagesPerformance
Usage
Quick Reference
- Name
- Github Cardmagic Messages
- Function
- Fuzzy search and browse Apple Messages/iMessage from CLI or MCP server
- Transport
- Package
- Language
- JavaScript/TypeScript
- Install
- brew install cardmagic/tap/messages
- Source
- External (Registry)
- License
- Open Source
Get started
Ready to integrate this MCP server?
Book a demo to see how this server fits your workflow, or explore the full catalog.