messages

Fuzzy search and browse Apple Messages (iMessage/SMS) from the command line, as a Claude Code plugin, or as an MCP server.

- Fuzzy searchwith typo tolerance across all your messages
- Browse recentmessages, contacts, and conversations
- Contact resolution- shows names instead of phone numbers
- Context display- see messages before/after each match
- Filter by senderor date range
- Auto-indexing- index automatically rebuilds when new messages are detected
- Multiple interfaces- CLI, MCP server, or Claude Code plugin

- macOS (reads from Apple Messages database)
- Node.js 22+
- Full Disk Access permission for your terminal (to read~/Library/Messages/chat.db)

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

- Skill: Claude automatically searches messages when you ask about texts/iMessages
- Slash commands:/messages:search,/messages:recent,/messages:from, and more

For direct MCP tool access without the plugin:

claude mcp add --transport stdio messages -- npx -y @cardmagic/messages --mcp

npm install -g @cardmagic/messages claude mcp add --transport stdio messages -- messages --mcp

git clone https://github.com/cardmagic/messages.git cd messages make install # Then add as plugin OR MCP server: claude plugin marketplace add cardmagic/ai-marketplace claude plugin install messages@cardmagic # OR claude mcp add --transport stdio messages -- messages --mcp

The tool needs to read your Messages database at~/Library/Messages/chat.db:
- OpenSystem Settings>Privacy & Security>Full Disk Access
- Click+and add your terminal app (Terminal.app, iTerm, Warp, etc.)
- Restart your terminal

# Show most recent messages (who texted me?) messages recent # List contacts by recent activity messages contacts --limit 10 # List conversations with message counts messages conversations # Show recent messages from someone messages from "Mom" # Show full conversation thread messages thread "John" --after 2024-12-01

# Search for messages (index auto-builds on first search) messages search "coffee tomorrow" # Filter by sender messages search "dinner" --from "Mom" # Filter by date messages search "meeting" --after 2024-01-01 # Adjust result count and context messages search "project" --limit 20 --context 5 # Show index statistics messages stats # Force rebuild the index messages index

Skill(auto-invoked): Claude automatically searches messages when you ask things like:

- "What did Mom say about dinner?"
- "Who texted me recently?"
- "Find messages about the trip"

When installed as an MCP server, Claude Code can use these tools:

For Claude Desktop or VS Code, add to your MCP configuration:

{ "mcpServers": { "messages": { "command": "npx", "args": ["-y", "@cardmagic/messages", "--mcp"] } } }

-

Auto-Indexing: On first search (or when new messages are detected), the tool automatically:

- Reads your Apple Messages SQLite database
- Builds a SQLite FTS5 full-text search index
- Creates a MiniSearch fuzzy search index
- Resolves contact names from your Address Book

Searching: Queries both indexes for best results with typo tolerance

Storage: Index files are stored in~/.messages/:

- index.db- SQLite FTS5 database
- fuzzy.json- MiniSearch index
- stats.json- Index statistics

Connect Claude, ChatGPT, and other AI tools to your Granola meeting notes via MCP. Query your notes, search transcripts, and get meeting insights in your favorite AI assistants.

Connect your Plaud recordings to any MCP-compatible AI client. Search recordings, read transcripts, and generate documents without leaving your AI assistant.

Agent-native forum for the x402/A2A ecosystem. The hosted MCP server exposes the whole forum as tools — threads, comments, votes, USDC bounties (Coinbase x402 on Base), provider reviews, and search. Endpoint: https://api.achivx.com/mcp/ (HTTP, OAuth 2.1).

Send native macOS notifications and interact with system dialogs.

Fetch and interact with Hacker News content, including top stories, comments, and search functionality.

25 read-only tools for searching, analyzing, and exploring your entire iMessage history on macOS. Spotify Wrapped for texts, conversation analytics, streaks, read receipts, reactions, and more.

A Python bridge for interacting with the macOS Messages app.

MCP server for full Gmail operations via Unipile API. 9 tools: send, reply, list, read, delete, search, labels, attachments, drafts. Dry-run by default, 55 unit tests. MIT licensed.

An MCP server for interacting with the Reddit API, enabling searches for posts, comments, and subreddits.