apple icloud mcp MCP

v0.3.3 changelog · 3

io.github.chrischall/apple-icloud-mcp

Unofficial: Apple Music, iCloud Calendar/Contacts/Mail, Apple Maps and WeatherKit, no Mac needed

transport:stdio runtime:npm

View source

Target client

run in your project directory

APPLE_TEAM_ID

APPLE_KEY_ID

APPLE_PRIVATE_KEY

APPLE_PRIVATE_KEY_PATH

APPLE_MUSIC_KEY_ID

APPLE_MUSIC_PRIVATE_KEY

APPLE_MAPS_KEY_ID

APPLE_MAPS_PRIVATE_KEY

APPLE_WEATHERKIT_KEY_ID

APPLE_WEATHERKIT_PRIVATE_KEY

APPLE_WEATHERKIT_SERVICE_ID

APPLE_MUSIC_DEVELOPER_TOKEN

APPLE_MUSIC_USER_TOKEN

APPLE_MUSIC_WEB_USER_TOKEN

APPLE_MUSIC_WEB_DEVELOPER_TOKEN

APPLE_MUSIC_STOREFRONT

ICLOUD_USERNAME

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

Held in this page only — never stored, logged, or sent anywhere but back to your screen.

claude mcp add apple-icloud-mcp -e APPLE_TEAM_ID=<APPLE_TEAM_ID> -e APPLE_KEY_ID=<APPLE_KEY_ID> -e APPLE_PRIVATE_KEY=<APPLE_PRIVATE_KEY> -e APPLE_PRIVATE_KEY_PATH=<APPLE_PRIVATE_KEY_PATH> -e APPLE_MUSIC_KEY_ID=<APPLE_MUSIC_KEY_ID> -e APPLE_MUSIC_PRIVATE_KEY=<APPLE_MUSIC_PRIVATE_KEY> -e APPLE_MAPS_KEY_ID=<APPLE_MAPS_KEY_ID> -e APPLE_MAPS_PRIVATE_KEY=<APPLE_MAPS_PRIVATE_KEY> -e APPLE_WEATHERKIT_KEY_ID=<APPLE_WEATHERKIT_KEY_ID> -e APPLE_WEATHERKIT_PRIVATE_KEY=<APPLE_WEATHERKIT_PRIVATE_KEY> -e APPLE_WEATHERKIT_SERVICE_ID=<APPLE_WEATHERKIT_SERVICE_ID> -e APPLE_MUSIC_DEVELOPER_TOKEN=<APPLE_MUSIC_DEVELOPER_TOKEN> -e APPLE_MUSIC_USER_TOKEN=<APPLE_MUSIC_USER_TOKEN> -e APPLE_MUSIC_WEB_USER_TOKEN=<APPLE_MUSIC_WEB_USER_TOKEN> -e APPLE_MUSIC_WEB_DEVELOPER_TOKEN=<APPLE_MUSIC_WEB_DEVELOPER_TOKEN> -e APPLE_MUSIC_STOREFRONT=<APPLE_MUSIC_STOREFRONT> -e ICLOUD_USERNAME=<ICLOUD_USERNAME> -e ICLOUD_APP_PASSWORD=<ICLOUD_APP_PASSWORD> -e ICLOUD_MAIL_ADDRESS=<ICLOUD_MAIL_ADDRESS> -e ICLOUD_DEFAULT_CALENDAR=<ICLOUD_DEFAULT_CALENDAR> -e APPLE_WRITE_MODE=<APPLE_WRITE_MODE> -e APPLE_SERVICES=<APPLE_SERVICES> -e DISPLAY_TZ=<DISPLAY_TZ> -e APPLE_UNITS=<APPLE_UNITS> -e APPLE_STATE_CACHE=<APPLE_STATE_CACHE> -e APPLE_REQUEST_TIMEOUT_MS=<APPLE_REQUEST_TIMEOUT_MS> -e APPLE_DEBUG_LOG=<APPLE_DEBUG_LOG> -e MCP_CONFIRM_MODE=<MCP_CONFIRM_MODE> -e MCP_CONFIRM_ELICITATION=<MCP_CONFIRM_ELICITATION> -e MCP_CONFIRM_TTL_SECONDS=<MCP_CONFIRM_TTL_SECONDS> -e MCP_CONFIRM_SECRET=<MCP_CONFIRM_SECRET> -- npx -y apple-icloud-mcp