# iCloud Mail

> iCloud Mail is an open-source MCP server. Read, search, draft, send and file iCloud Mail over IMAP and SMTP. No tool destroys mail. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Repository:** https://github.com/julienrabault/icloud-mcp
- **MCP Registry name:** io.github.JulienRabault/icloud-mcp
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add icloud-mcp --env ICLOUD_EMAIL='<ICLOUD_EMAIL>' --env ICLOUD_APP_PASSWORD='<ICLOUD_APP_PASSWORD>' -- uvx icloud-mail-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "icloud-mcp": {
      "command": "uvx",
      "args": [
        "icloud-mail-mcp"
      ],
      "env": {
        "ICLOUD_EMAIL": "<ICLOUD_EMAIL>",
        "ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "icloud-mcp": {
      "command": "uvx",
      "args": [
        "icloud-mail-mcp"
      ],
      "env": {
        "ICLOUD_EMAIL": "<ICLOUD_EMAIL>",
        "ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "icloud-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "icloud-mail-mcp"
      ],
      "env": {
        "ICLOUD_EMAIL": "<ICLOUD_EMAIL>",
        "ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "icloud-mcp": {
      "command": "uvx",
      "args": [
        "icloud-mail-mcp"
      ],
      "env": {
        "ICLOUD_EMAIL": "<ICLOUD_EMAIL>",
        "ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "icloud-mcp": {
      "command": "uvx",
      "args": [
        "icloud-mail-mcp"
      ],
      "env": {
        "ICLOUD_EMAIL": "<ICLOUD_EMAIL>",
        "ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>"
      }
    }
  }
}
```

## FAQ

### Is iCloud Mail free?

Yes. iCloud Mail is open source, so you can use and self-host it for free.

### How do I add iCloud Mail to Claude Code?

Run this command in your terminal: claude mcp add icloud-mcp --env ICLOUD_EMAIL='<ICLOUD_EMAIL>' --env ICLOUD_APP_PASSWORD='<ICLOUD_APP_PASSWORD>' -- uvx icloud-mail-mcp

## Where this comes from

- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.

---
Source: https://ai-powered.com/mcp/icloud-mail
