loading…
Search for a command to run...
loading…
Enables reading, searching, and sending iMessages on macOS by accessing the local messages database and utilizing AppleScript. Users can list conversations, sea
Enables reading, searching, and sending iMessages on macOS by accessing the local messages database and utilizing AppleScript. Users can list conversations, search message history, and send messages to individuals or group chats directly through the Model Context Protocol.
MCP server that exposes iMessage read/send capabilities on macOS. Runs on a Mac with Messages.app and can be accessed remotely via SSH over Tailscale.
| Tool | Description |
|---|---|
list_conversations |
List recent conversations with last message preview |
get_messages |
Get messages from a specific conversation |
search_messages |
Full-text search across all messages |
get_contact_info |
Look up contact stats by phone/email |
send_message |
Send an iMessage to a phone number or email |
send_group_message |
Send a message to a named group chat |
uv run imessage-mcp
Requires macOS with Messages.app and Full Disk Access for the terminal process.
{
"mcpServers": {
"imessage": {
"command": "uv",
"args": ["--directory", "/path/to/imessage-mcp", "run", "imessage-mcp"]
}
}
}
From any device on the Tailscale network:
{
"mcpServers": {
"imessage": {
"command": "ssh",
"args": [
"mba-server",
"/Users/viraat/.local/bin/uv --directory /Users/viraat/Documents/imessage-mcp run imessage-mcp"
]
}
}
}
This pipes MCP stdio through SSH — the server runs on the Mac, reads chat.db, and sends via AppleScript.
Добавь это в claude_desktop_config.json и перезапусти Claude Desktop.
{
"mcpServers": {
"imessage-mcp-server": {
"command": "npx",
"args": []
}
}
}