mcpbeat Sign in

iCloud Mail MCP Server

by julienrabault Your server? Claim it
local only

iCloud Mail runs on your own machine — the client starts it, so there is no endpoint to ping. 190 installs a week from pypi. Last commit 22 Sep 2026.

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

Installs per day peak 47 · avg 22 · +83% w/w
a month agotoday
190
Installs / week
pypi · icloud-mail-mcp
1
Stars
0 open issues
22 Sep 2026
Last commit
from GitHub
MIT
License
Python

Nothing serious here today

Today is the operative word: we check iCloud Mail every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add icloud-mcp -e 'ICLOUD_EMAIL=<ICLOUD_EMAIL>' -e 'ICLOUD_APP_PASSWORD=<ICLOUD_APP_PASSWORD>' -- uvx icloud-mail-mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "icloud-mcp": {
      "command": "uvx",
      "args": [
        "icloud-mail-mcp"
      ],
      "env": {
        "ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>",
        "ICLOUD_EMAIL": "<ICLOUD_EMAIL>"
      }
    }
  }
}
~/.codex/config.toml
[mcp_servers.icloud-mcp]
command = "uvx"
args = ["icloud-mail-mcp"]
env = { ICLOUD_EMAIL = "<ICLOUD_EMAIL>", ICLOUD_APP_PASSWORD = "<ICLOUD_APP_PASSWORD>" }
.cursor/mcp.json
{
  "mcpServers": {
    "icloud-mcp": {
      "command": "uvx",
      "args": [
        "icloud-mail-mcp"
      ],
      "env": {
        "ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>",
        "ICLOUD_EMAIL": "<ICLOUD_EMAIL>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "icloud-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "icloud-mail-mcp"
      ],
      "env": {
        "ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>",
        "ICLOUD_EMAIL": "<ICLOUD_EMAIL>"
      }
    }
  }
}

Put your own values in place of <ICLOUD_EMAIL> (Your iCloud address, for example [email protected]), <ICLOUD_APP_PASSWORD> (An app-specific password generated at account.apple.com. iCloud rejects your main password over IMAP). The author’s registry entry marks them as required.

Optional settings from the registry entry, left out of the block above: ICLOUD_DISPLAY_NAME (Name shown in the From header of sent mail. Defaults to the local part of the address).

Alternatives to iCloud Mail

same job, measured the same way
M
MailMCP
by mcpproducts

Read, search and draft email over IMAP from any AI agent. Never sends.

168 installs/wk local only
IMAP Draft
by zedong-peng

IMAP mail for agents: search, read and write drafts. It can't send, move or delete.

local only
emperor-mail
by yarenty

Email over IMAP and SMTP: search and read messages and attachments; draft and send when switched on

local only
Fluxmail
by fluxmailai

Read, search, draft, send, and organize email through Gmail, Outlook, and IMAP/SMTP mailboxes.

1 604 installs/wk local only
email-tool
by skhan61

IMAP/SMTP email for AI assistants: read, search, draft and send, with CMMC-grade safeguards.

392 installs/wk local only
Proton Mail (unofficial)
by sethbang

Unofficial Proton Mail MCP — send, read, search & organize email over SMTP and IMAP

88 installs/wk local only
MCP Server Imap
by aiwerk

Email tools for any IMAP/SMTP provider: list, read, search, send, and manage messages.

local only
Mailbox
by psyb0t

Scoped IMAP/SMTP access over HTTP and MCP: read, organize, draft, reply and send mail.

local only

iCloud Mail — questions

Answers built from our own checks of this server.

Why is there no uptime for iCloud Mail?
iCloud Mail runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the pypi package icloud-mail-mcp was installed 190 times last week.
How do I connect iCloud Mail?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls icloud-mail-mcp straight from pypi; nothing to host, nothing to sign up for.
How many people use iCloud Mail?
The pypi package icloud-mail-mcp was installed 190 times in the last week. Week over week that is +83%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is iCloud Mail open source?
Yes — it is published under the MIT licence, written in Python and 1 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.