Install iCloud for Claude Desktop
Claude Desktop reads mcpServers from claude_desktop_config.json. Restart the app after saving.
- Open ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows, or ~/.config/Claude/claude_desktop_config.json on Linux.
- Paste the JSON config below.
- Replace placeholder secrets, then restart the client if it does not reload on its own.
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"epinethrone-icloud-mcp": {
"command": "uvx",
"args": [
"icloud-mcp-server"
],
"env": {
"ICLOUD_USERNAME": "",
"ICLOUD_APP_PASSWORD": "YOUR_ICLOUD_APP_PASSWORD",
"ICLOUD_DISPLAY_NAME": "",
"DEFAULT_TIMEZONE": "UTC",
"SEND_REQUIRES_APPROVAL": "true",
"AGENT_NOTES_FILE": "",
"OWNER_ADDRESSES": "",
"WARMUP_ON_START": "true",
"TOOL_WORKERS": "8"
}
}
}
}