msgmcp

<div align='center'> <h3>msgmcp</h3> <p>MCP server for reading, sending, and reacting to iMessages on macOS</p> <br/> <br/> </div>

A Model Context Protocol server that gives LLMs full access to your iMessage conversations. Reads directly from the macOS Messages database for retrieval and uses AppleScript for sending messages and tapback reactions, all exposed as structured MCP tools.

• Conversation Access: List recent conversations, read full message history, and check unread messages
• Full-Text Search: Search across all conversations or within a specific thread
• Send Messages: Send iMessages or SMS to any contact via AppleScript automation
• Tapback Reactions: Add love, like, dislike, laugh, emphasize, or question reactions
• Attachment Handling: List and read attachments with base64 encoding for image transport
• Contact Resolution: Automatically resolves phone numbers and emails to names via the macOS Address Book
• Contact Statistics: Message counts, sent/received breakdown, and conversation date ranges

• macOS (requires access to ~/Library/Messages/chat.db and the Contacts database)
• Full Disk Access granted to your terminal or host application
• Bun runtime

git clone https://github.com/plyght/msgmcp.git
cd msgmcp
bun install
bun run build

# Development mode with hot reload
bun run dev

# Production
bun run start

Add to your MCP client configuration:

{
  "mcpServers": {
    "msgmcp": {
      "command": "node",
      "args": ["dist/stdio.js"]
    }
  }
}

| Tool | Description | |---|---| | list-conversations | List recent conversations with last message preview | | read-messages | Read message history for a conversation, with optional date filtering | | search-messages | Full-text search across all or specific conversations | | unread-messages | Get all conversations with unread messa