Apple Messages
Read message history and send iMessages from Messages.app on a Mac
- Pricing
- Open source
- Platforms
- macOS, CLI
- Runs
- Locally
- Version
- 1.1.7
- Listing updated
- today
Similar MCP servers
About Apple Messages
Apple Messages is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.
Apple Messages MCP lets an agent list conversations with pagination, search messages, view attachment metadata, and send or reply through Messages.app. It also exposes unread and recent conversation resources.
Two macOS permissions matter: Automation access for sending, and Full Disk Access to read history from the Messages database and copy files for attachments. The health check does not send Apple Events, so closed Messages reports not_probed and running Messages unknown, which does not mean denial. Timeouts are five seconds for diagnostics and 30 for sends, and the README says to check delivery before retrying a timed-out send.
It runs over stdio with uvx.
Install
Run in a terminal
claude mcp add apple-messages-mcp -- uvx apple-messages-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"apple-messages-mcp": {
"command": "uvx",
"args": [
"apple-messages-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"apple-messages-mcp": {
"command": "uvx",
"args": [
"apple-messages-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"apple-messages-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"apple-messages-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"apple-messages-mcp": {
"command": "uvx",
"args": [
"apple-messages-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"apple-messages-mcp": {
"command": "uvx",
"args": [
"apple-messages-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
APPLE_MESSAGES_MCP_SAFETY_MODESafety mode for Messages operations: safe_readonly, safe_manage, or full_access.APPLE_MESSAGES_MCP_ALLOWED_ROOTSComma-separated folders messages_send_attachment may send files from. Unset uses APPLE_FILES_MCP_ALLOWED_ROOTS, then the default folders.
Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- messages_health
- Checks health.
- messages_permission_guide
- Explains permissions.
- messages_recheck_permissions
- Rechecks permissions.
- messages_send_attachment
- Sends an attachment.
What it does
- Conversation list
- Paginated conversations.
- Message search
- Search with attachment metadata.
- Send and reply
- Via Messages.app.
- Attachments
- Send files.
- Permission diagnostics
- Separates history from automation failures.
- Resources
- Unread and recent conversations.
Good for
- Find a past conversation
- Reply to a message
- Send a file
- Check what permission is missing
Pricing
Open source
Free; runs locally
Apple Messages FAQ
Permissions?
Automation for sending, Full Disk Access for history.
Install?
uvx apple-messages-mcp.
Retry sends?
Check delivery first after a timeout.
Is Apple Messages free?
Yes. Apple Messages is open source, so you can use and self-host it for free.
How do I add Apple Messages to Claude Code?
Run this command in your terminal: claude mcp add apple-messages-mcp -- uvx apple-messages-mcp
What are the best alternatives to Apple Messages?
The closest alternatives to Apple Messages are TrendRadar, Getmitra, Discord, Zoom and Email Spam Tester.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

