How antondkg/mcp-imessage works
mcp-imessage is a macOS MCP server for browsing and searching local Messages history, looking up Contacts.app entries, and optionally sending or drafting messages. The main workflow runs from an MCP client through the Rust tool server to local data or Messages.app; draft results can open in the embedded React UI for review and approval. README capabilities fill in unsampled tool behavior. Source excerpts show selected calls and UI rendering, but not every route or UI handoff.
Main entry points: main.rs MCP tool server · main.tsx Embedded UI app · messages.rs Thread and message queries · contacts.rs Contact lookup
Components 15
MCP server
- MCP tool server
src/main.rs - Thread tools
src/main.rs - Message search tool
src/main.rs - Contact tools
src/main.rs
Local data
- Thread and message queries
src/messages.rs - Messages database
- Contact lookup
src/contacts.rs - Contacts.app
Send and draft
- Send and draft tools
src/main.rs - Send validation and delivery
src/send.rs - Messages.app
Embedded UI
- Embedded UI app
ui/src/main.tsx - Conversation and contact views
ui/src/imessage-components.tsx - Composable UI catalog
ui/src/catalog.ts
Other components
- MCP client
Connections 18
- MCP client → MCP tool server: calls tools
README.md - MCP tool server → Thread tools: registers routes
src/main.rs - MCP tool server → Message search tool: registers routes
src/main.rs - MCP tool server → Contact tools: registers routes
src/main.rs - MCP tool server → Send and draft tools: registers routes
src/main.rs - Thread tools → Thread and message queries: calls queries
src/main.rs - Message search tool → Thread and message queries: calls search
src/main.rs - Contact tools → Contact lookup: searches contacts
src/main.rs - Thread and message queries → Messages database: reads history
README.md - Thread and message queries → Contact lookup: resolves names
src/messages.rs - Contact lookup → Contacts.app: looks up contacts
- Send and draft tools → Send validation and delivery: validates requests
src/main.rs - Send validation and delivery → Messages.app: sends messages
README.md - Send and draft tools → Embedded UI app: returns draft view
- Embedded UI app → MCP client: receives tool results
- Embedded UI app → Conversation and contact views: renders views
ui/src/main.tsx - Embedded UI app → Composable UI catalog: registers components
ui/src/main.tsx - Conversation and contact views → Send and draft tools: requests draft approval send