# Apple Messages

> Apple Messages is an open-source MCP server for communication. Read message history and send iMessages from Messages.app on a Mac. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, CLI
- **Repository:** https://github.com/jonathanrreed/apple-mcps/tree/HEAD/AppleMessages-MCP
- **MCP Registry name:** io.github.JonathanRReed/apple-messages-mcp
- **Categories:** [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add apple-messages-mcp -- uvx apple-messages-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "apple-messages-mcp": {
      "command": "uvx",
      "args": [
        "apple-messages-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "apple-messages-mcp": {
      "command": "uvx",
      "args": [
        "apple-messages-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "apple-messages-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "apple-messages-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "apple-messages-mcp": {
      "command": "uvx",
      "args": [
        "apple-messages-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "apple-messages-mcp": {
      "command": "uvx",
      "args": [
        "apple-messages-mcp"
      ]
    }
  }
}
```

## Tools

- `messages_health`: Checks health.
- `messages_permission_guide`: Explains permissions.
- `messages_recheck_permissions`: Rechecks permissions.
- `messages_send_attachment`: Sends an attachment.

## 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.

## Alternatives

- [TrendRadar](https://ai-powered.com/mcp/trendradar): TrendRadar is an open-source MCP server for communication.
- [Getmitra](https://ai-powered.com/mcp/getmitra): Getmitra is an MCP server for communication.
- [Discord](https://ai-powered.com/mcp/discord-2): Discord is a freemium MCP server for communication.
- [Zoom](https://ai-powered.com/mcp/zoom): Zoom is a freemium MCP server for communication.
- [Email Spam Tester](https://ai-powered.com/mcp/email-spam-tester): Email Spam Tester is a free MCP server for communication.
- [Slack_connect](https://ai-powered.com/mcp/slack-connect): Slack_connect is a freemium MCP server for communication.
- [Postmark](https://ai-powered.com/mcp/postmark): Postmark is a freemium MCP server for communication.
- [Gmail](https://ai-powered.com/mcp/gmail-5): Gmail is a freemium MCP server for communication.

---
Source: https://ai-powered.com/mcp/apple-messages
