Loading...
A Python MCP server enabling interaction with macOS Messages for sending and receiving messages via iMessage or SMS, with automatic fallback and contact filtering.
Boost this tool
Subscribe to listing upgrades or segmented pushes.
A Python MCP server enabling interaction with macOS Messages for sending and receiving messages via iMessage or SMS, with automatic fallback and contact filtering.
This server is relatively safe for read operations, but sending messages, especially SMS, introduces risks due to potential data exposure. Ensure Full Disk Access is granted only to trusted applications and be mindful of the content sent via SMS.
Performance depends on the size of the Messages database and the speed of the macOS system. Large message histories may impact response times.
No direct monetary costs, but SMS messages may incur charges depending on the user's mobile plan.
brew install uv{
"mcpServers": {
"messages": {
"command": "uvx",
"args": [
"mac-messages-mcp"
]
}
}
}MCP_MESSAGES_URLget_recent_messagesRetrieves recent messages from the macOS Messages database.
Read-only operation; no modification of data.
send_messageSends a message via iMessage or SMS/RCS.
Writes data by sending messages, but does not modify existing data.
check_imessage_availabilityChecks if a recipient is available on iMessage.
Read-only operation; no modification of data.
None
hybrid
This server is relatively safe for read operations, but sending messages, especially SMS, introduces risks due to potential data exposure. Ensure Full Disk Access is granted only to trusted applications and be mindful of the content sent via SMS.
This server operates with the permissions of the user running it, including access to the Messages database. Exercise caution when granting autonomy.
Production Tip
Implement robust error handling and logging for production environments. Consider using mcp-proxy with authentication for secure remote access.
Yes, it supports sending messages to multiple recipients, effectively handling group messages.
The current version does not explicitly support sending attachments. This would require further development.
Use mcp-proxy with authentication, restrict network access, and implement robust error handling and logging.
Yes, it interacts directly with the macOS Messages app, which syncs with iCloud.
The server automatically falls back to sending an SMS message.
The `get_recent_messages` function allows filtering by time (hours). More specific date filtering would require custom code.
No, this server can only access messages currently stored in the Messages database.