iCloud Mail MCP Server

by julienrabaultio.github.JulienRabault/icloud-mcpv0.1.1

iCloud Mail over IMAP and SMTP: search all folders, rebuild threads, save attachments, draft replies and file messages by rule, without marking mail as read.

0Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active17d ago

Install iCloud Mail MCP server

claude mcp add icloud-mail -e ICLOUD_EMAIL='<icloud-email>' -e ICLOUD_APP_PASSWORD='<icloud-app-password>' -- uvx icloud-mail-mcp

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

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

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

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

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

Add to .vscode/mcp.json in your workspace.

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

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
ICLOUD_EMAIL	yes	—	Your iCloud address, for example you@icloud.com.
ICLOUD_APP_PASSWORD	yes	yes	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.

Freshness

Active — last maintenance signal 17d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-22 · 17d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-09-22 · 17d ago · official registry · v0.1.1

FAQ

›How do I install the iCloud Mail MCP server in Claude Code?

Run: claude mcp add icloud-mail -e ICLOUD_EMAIL='<icloud-email>' -e ICLOUD_APP_PASSWORD='<icloud-app-password>' -- uvx icloud-mail-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does iCloud Mail require an API key?

Yes. It expects ICLOUD_EMAIL, ICLOUD_APP_PASSWORD, of which 1 is a secret.

›Can I use iCloud Mail as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is iCloud Mail in the official MCP registry?

Yes, as io.github.JulienRabault/icloud-mcp.