Which integrations are available for this server?

Allows reading and sending iMessages on macOS, including sending text, files, managing chats, and checking for new messages.

How do I use imessage-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. 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.

imessage-mcp

by aryanma

Overview Schema Related Servers Score Discussions

Python

Local

imessage-mcp

MCP server for iMessage on macOS. Read and send messages via AI agents.

Requirements

macOS
Python 3.10+
Full Disk Access (for reading messages)
Messages.app running (for sending)

Related MCP server: jons-mcp-imessage

Setup

uv sync

Grant Full Disk Access

System Settings → Privacy & Security → Full Disk Access
Add your terminal (Terminal, iTerm, VS Code, Cursor)
Restart the terminal

Run

cd src && python main.py

Server runs at http://127.0.0.1:8080/mcp

Architecture

Layer	Component	Description
Transport	HTTP/MCP	Streamable HTTP via dedalus-mcp
Reads	`chat.db`	Direct SQL on `~/Library/Messages/chat.db`
Sends	`osascript`	AppleScript RPC to Messages.app

Tools

Tool	Description
`check_status`	Check if iMessage is ready
`read_messages`	Read messages (filters: chat_id, search, since, chronological)
`list_chats`	List conversations
`get_chat_participants`	Get chat members
`get_unread_messages`	Get unread messages
`get_attachments`	Get attachments for a message
`download_attachment`	Copy attachment to local path
`send_imessage`	Send text to phone/email
`send_to_group`	Send text to group chat
`send_file`	Send file to phone/email
`send_file_to_group`	Send file to group chat
`lookup_contact`	Search Contacts.app by name
`start_watching`	Start watching for new messages
`check_new_messages`	Get messages since last check
`stop_watching`	Stop watching

MCP Config

Add to Claude Desktop config:

{
  "mcpServers": {
    "imessage": {
      "url": "http://127.0.0.1:8080/mcp"
    }
  }
}

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/aryanma/imessage-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server