Skip to content
MCP server

Apple Messages

Read message history and send iMessages from Messages.app on a Mac

Runs locallyStatus and history
Install
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-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "apple-messages-mcp": {
      "command": "uvx",
      "args": [
        "apple-messages-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "apple-messages-mcp": {
      "command": "uvx",
      "args": [
        "apple-messages-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers