iCloud — Claude Code MCP server: features and setup
Connect an AI agent to iCloud Mail, Calendar and Drive to search messages, check availability or locate files. Sending email requires approval.
claude mcp add --env ICLOUD_USERNAME=<ICLOUD_USERNAME> --env ICLOUD_APP_PASSWORD=<ICLOUD_APP_PASSWORD> --env ICLOUD_DISPLAY_NAME=<ICLOUD_DISPLAY_NAME> --env DEFAULT_TIMEZONE=<DEFAULT_TIMEZONE> --env SEND_REQUIRES_APPROVAL=<SEND_REQUIRES_APPROVAL> --transport stdio icloud -- uvx icloud-mcp-serverWhat iCloud does
The MCP server gives an agent access to iCloud Mail, Calendar, Contacts, Reminders, Notes and iCloud Drive. It can search messages and files, check calendar availability, and manage reminders. Maps and Messages are available too; sending Messages is disabled by default.
Run the server locally or host it yourself. Sign-in uses an iCloud username and an app-specific password, which stays on your machine. Outgoing email waits for approval or goes to Drafts, while invitations to other people are turned off. You’ll need an app-specific password to connect the account.
What it helps with
- search email by topic or sender
- check calendar availability
- locate a document in iCloud Drive
- create a reminder for a date
- draft an email reply that waits for approval
Example prompts for the agent
- Find the email about my heating and draft a polite reply.
- Check when I have an hour free next week.
- Find my tax return in iCloud Drive and tell me what I paid last year.
How to install iCloud
Platform CLI
claude mcp add --env ICLOUD_USERNAME=<ICLOUD_USERNAME> --env ICLOUD_APP_PASSWORD=<ICLOUD_APP_PASSWORD> --env ICLOUD_DISPLAY_NAME=<ICLOUD_DISPLAY_NAME> --env DEFAULT_TIMEZONE=<DEFAULT_TIMEZONE> --env SEND_REQUIRES_APPROVAL=<SEND_REQUIRES_APPROVAL> --transport stdio icloud -- uvx icloud-mcp-serverReplace <…> with your own values. 4 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from icloud-mcp-server <command>
Platform CLI
codex mcp add icloud --env ICLOUD_USERNAME=<ICLOUD_USERNAME> --env ICLOUD_APP_PASSWORD=<ICLOUD_APP_PASSWORD> --env ICLOUD_DISPLAY_NAME=<ICLOUD_DISPLAY_NAME> --env DEFAULT_TIMEZONE=<DEFAULT_TIMEZONE> --env SEND_REQUIRES_APPROVAL=<SEND_REQUIRES_APPROVAL> -- uvx icloud-mcp-serverReplace <…> with your own values. 4 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from icloud-mcp-server <command>
Config file
{
"mcpServers": {
"icloud": {
"command": "uvx",
"args": [
"icloud-mcp-server"
],
"env": {
"ICLOUD_USERNAME": "<ICLOUD_USERNAME>",
"ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>",
"ICLOUD_DISPLAY_NAME": "<ICLOUD_DISPLAY_NAME>",
"DEFAULT_TIMEZONE": "<DEFAULT_TIMEZONE>",
"SEND_REQUIRES_APPROVAL": "<SEND_REQUIRES_APPROVAL>"
}
}
}
}Replace <…> with your own values. 4 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from icloud-mcp-server <command>
Config file
{
"servers": {
"icloud": {
"type": "stdio",
"command": "uvx",
"args": [
"icloud-mcp-server"
],
"env": {
"ICLOUD_USERNAME": "<ICLOUD_USERNAME>",
"ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>",
"ICLOUD_DISPLAY_NAME": "<ICLOUD_DISPLAY_NAME>",
"DEFAULT_TIMEZONE": "<DEFAULT_TIMEZONE>",
"SEND_REQUIRES_APPROVAL": "<SEND_REQUIRES_APPROVAL>"
}
}
}
}Replace <…> with your own values. 4 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from icloud-mcp-server <command>
Platform CLI
gemini mcp add -e ICLOUD_USERNAME=<ICLOUD_USERNAME> -e ICLOUD_APP_PASSWORD=<ICLOUD_APP_PASSWORD> -e ICLOUD_DISPLAY_NAME=<ICLOUD_DISPLAY_NAME> -e DEFAULT_TIMEZONE=<DEFAULT_TIMEZONE> -e SEND_REQUIRES_APPROVAL=<SEND_REQUIRES_APPROVAL> icloud uvx icloud-mcp-serverReplace <…> with your own values. 4 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from icloud-mcp-server <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about iCloud
How do I install iCloud in Claude Code?
Run claude mcp add icloud-mcp -e ICLOUD_USERNAME=<ICLOUD_USERNAME> -e ICLOUD_APP_PASSWORD=<ICLOUD_APP_PASSWORD> -- uvx icloud-mcp-server. Provide your iCloud username and app-specific password.
What does iCloud do?
It connects an MCP client to iCloud Mail, Calendar, Contacts, Reminders, Notes and Drive. An agent can search this content and perform supported actions.
Do I need an app-specific password?
Yes. The server uses an app-specific password to sign in, and keeps it on your machine.
