Install apple-icloud-mcp 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": {
"chrischall-apple-icloud-mcp": {
"command": "npx",
"args": [
"-y",
"apple-icloud-mcp@0.3.6"
],
"env": {
"APPLE_TEAM_ID": "",
"APPLE_KEY_ID": "",
"APPLE_PRIVATE_KEY": "YOUR_APPLE_PRIVATE_KEY",
"APPLE_PRIVATE_KEY_PATH": "",
"APPLE_MUSIC_KEY_ID": "",
"APPLE_MUSIC_PRIVATE_KEY": "YOUR_APPLE_MUSIC_PRIVATE_KEY",
"APPLE_MAPS_KEY_ID": "",
"APPLE_MAPS_PRIVATE_KEY": "YOUR_APPLE_MAPS_PRIVATE_KEY",
"APPLE_WEATHERKIT_KEY_ID": "",
"APPLE_WEATHERKIT_PRIVATE_KEY": "YOUR_APPLE_WEATHERKIT_PRIVATE_KEY",
"APPLE_WEATHERKIT_SERVICE_ID": "",
"APPLE_MUSIC_DEVELOPER_TOKEN": "YOUR_APPLE_MUSIC_DEVELOPER_TOKEN",
"APPLE_MUSIC_USER_TOKEN": "YOUR_APPLE_MUSIC_USER_TOKEN",
"APPLE_MUSIC_WEB_USER_TOKEN": "YOUR_APPLE_MUSIC_WEB_USER_TOKEN",
"APPLE_MUSIC_WEB_DEVELOPER_TOKEN": "YOUR_APPLE_MUSIC_WEB_DEVELOPER_TOKEN",
"APPLE_MUSIC_STOREFRONT": "",
"ICLOUD_USERNAME": "",
"ICLOUD_APP_PASSWORD": "YOUR_ICLOUD_APP_PASSWORD",
"ICLOUD_MAIL_ADDRESS": "",
"ICLOUD_DEFAULT_CALENDAR": "",
"APPLE_WRITE_MODE": "",
"APPLE_SERVICES": "",
"DISPLAY_TZ": "",
"APPLE_UNITS": "",
"APPLE_STATE_CACHE": "",
"APPLE_REQUEST_TIMEOUT_MS": "",
"APPLE_DEBUG_LOG": "",
"MCP_CONFIRM_MODE": "",
"MCP_CONFIRM_ELICITATION": "",
"MCP_CONFIRM_TTL_SECONDS": "",
"MCP_CONFIRM_SECRET": "YOUR_MCP_CONFIRM_SECRET"
}
}
}
}