iCloud Mail MCP Server

io.github.JulienRabault/icloud-mcp

Repository Registry

What is the iCloud Mail MCP server?

Read, search, draft, send and file iCloud Mail over IMAP and SMTP. No tool destroys mail.

How to install iCloud Mail

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

ICLOUD_EMAIL
required
Your iCloud address, for example you@icloud.com.
ICLOUD_APP_PASSWORD
required
secret
An app-specific password generated at account.apple.com. iCloud rejects your main password over IMAP.
ICLOUD_DISPLAY_NAME
Name shown in the From header of sent mail. Defaults to the local part of the address.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "icloud-mcp": {
      "command": "uvx",
      "args": [
        "icloud-mail-mcp"
      ],
      "env": {
        "ICLOUD_EMAIL": "<YOUR_ICLOUD_EMAIL>",
        "ICLOUD_APP_PASSWORD": "<YOUR_ICLOUD_APP_PASSWORD>",
        "ICLOUD_DISPLAY_NAME": "<YOUR_ICLOUD_DISPLAY_NAME>"
      }
    }
  }
}