Allows reading and sending iMessages on macOS, including sending text, files, managing chats, and checking for new messages.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@imessage-mcp show my unread messages"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP server for iMessage on macOS. Read and send messages via AI agents.
macOS
Python 3.10+
Full Disk Access (for reading messages)
Messages.app running (for sending)
Related MCP server: jons-mcp-imessage
uv syncSystem Settings → Privacy & Security → Full Disk Access
Add your terminal (Terminal, iTerm, VS Code, Cursor)
Restart the terminal
cd src && python main.pyServer runs at http://127.0.0.1:8080/mcp
Layer | Component | Description |
Transport | HTTP/MCP | Streamable HTTP via dedalus-mcp |
Reads |
| Direct SQL on |
Sends |
| AppleScript RPC to Messages.app |
Tool | Description |
| Check if iMessage is ready |
| Read messages (filters: chat_id, search, since, chronological) |
| List conversations |
| Get chat members |
| Get unread messages |
| Get attachments for a message |
| Copy attachment to local path |
| Send text to phone/email |
| Send text to group chat |
| Send file to phone/email |
| Send file to group chat |
| Search Contacts.app by name |
| Start watching for new messages |
| Get messages since last check |
| Stop watching |
Add to Claude Desktop config:
{
"mcpServers": {
"imessage": {
"url": "http://127.0.0.1:8080/mcp"
}
}
}This server cannot be deployed
MCP connector for iMessage & Contacts via a local Mac agent + Vercel relay
Let ChatGPT, Claude & Cursor use your Mac: email, calendar, iMessage, Teams, files. Local, free.
Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.
MCP connector that lets ChatGPT list, search, and run your Apple Shortcuts via a local Mac agent
