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.
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.
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.
claude mcp add icloud-mcp -e 'ICLOUD_EMAIL=<ICLOUD_EMAIL>' -e 'ICLOUD_APP_PASSWORD=<ICLOUD_APP_PASSWORD>' -- uvx icloud-mail-mcp
{
"mcpServers": {
"icloud-mcp": {
"command": "uvx",
"args": [
"icloud-mail-mcp"
],
"env": {
"ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>",
"ICLOUD_EMAIL": "<ICLOUD_EMAIL>"
}
}
}
}
[mcp_servers.icloud-mcp]
command = "uvx"
args = ["icloud-mail-mcp"]
env = { ICLOUD_EMAIL = "<ICLOUD_EMAIL>", ICLOUD_APP_PASSWORD = "<ICLOUD_APP_PASSWORD>" }
{
"mcpServers": {
"icloud-mcp": {
"command": "uvx",
"args": [
"icloud-mail-mcp"
],
"env": {
"ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>",
"ICLOUD_EMAIL": "<ICLOUD_EMAIL>"
}
}
}
}
{
"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).
Read, search and draft email over IMAP from any AI agent. Never sends.
IMAP mail for agents: search, read and write drafts. It can't send, move or delete.
Email over IMAP and SMTP: search and read messages and attachments; draft and send when switched on
Read, search, draft, send, and organize email through Gmail, Outlook, and IMAP/SMTP mailboxes.
IMAP/SMTP email for AI assistants: read, search, draft and send, with CMMC-grade safeguards.
Unofficial Proton Mail MCP — send, read, search & organize email over SMTP and IMAP
Email tools for any IMAP/SMTP provider: list, read, search, send, and manage messages.
Scoped IMAP/SMTP access over HTTP and MCP: read, organize, draft, reply and send mail.
Answers built from our own checks of this server.