apple-icloud-mcp

io.github.chrischall/apple-icloud-mcp · version 0.4.0

Community listing. Not installed or verified by cosmic-mcp. Read the source and its permissions before you run it.

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

https://github.com/chrischall/apple-icloud-mcp

Quick facts

Listing: Community
Published Nov 4, 18:09 UTC
Transport: stdio
Package: npm apple-icloud-mcp 0.4.0
Listed by cosmic-mcp: Nov 9, 04:25 UTC

Details

Repository: https://github.com/chrischall/apple-icloud-mcp
npm: https://www.npmjs.com/package/apple-icloud-mcp
Needs settings: 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

Audio and speech Maps and location

Setup snippets

Generated from the registry entry. cosmic-mcp has not run or reviewed this server; values in angle brackets are yours to fill in.

Run it locally (npm)

npx -y '[email protected]'

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "apple-icloud-mcp": {
      "args": [
        "-y",
        "[email protected]"
      ],
      "command": "npx",
      "env": {
        "APPLE_DEBUG_LOG": "<your apple debug log>",
        "APPLE_KEY_ID": "<your apple key id>",
        "APPLE_MAPS_KEY_ID": "<your apple maps key id>",
        "APPLE_MAPS_PRIVATE_KEY": "<your apple maps private key>",
        "APPLE_MUSIC_DEVELOPER_TOKEN": "<your apple music developer token>",
        "APPLE_MUSIC_KEY_ID": "<your apple music key id>",
        "APPLE_MUSIC_PRIVATE_KEY": "<your apple music private key>",
        "APPLE_MUSIC_STOREFRONT": "<your apple music storefront>",
        "APPLE_MUSIC_USER_TOKEN": "<your apple music user token>",
        "APPLE_MUSIC_WEB_DEVELOPER_TOKEN": "<your apple music web developer token>",
        "APPLE_MUSIC_WEB_USER_TOKEN": "<your apple music web user token>",
        "APPLE_PRIVATE_KEY": "<your apple private key>",
        "APPLE_PRIVATE_KEY_PATH": "<your apple private key path>",
        "APPLE_REQUEST_TIMEOUT_MS": "<your apple request timeout ms>",
        "APPLE_SERVICES": "<your apple services>",
        "APPLE_STATE_CACHE": "<your apple state cache>",
        "APPLE_TEAM_ID": "<your apple team id>",
        "APPLE_UNITS": "<your apple units>",
        "APPLE_WEATHERKIT_KEY_ID": "<your apple weatherkit key id>",
        "APPLE_WEATHERKIT_PRIVATE_KEY": "<your apple weatherkit private key>",
        "APPLE_WEATHERKIT_SERVICE_ID": "<your apple weatherkit service id>",
        "APPLE_WRITE_MODE": "<your apple write mode>",
        "DISPLAY_TZ": "<your display tz>",
        "ICLOUD_APP_PASSWORD": "<your icloud app password>",
        "ICLOUD_DEFAULT_CALENDAR": "<your icloud default calendar>",
        "ICLOUD_MAIL_ADDRESS": "<your icloud mail address>",
        "ICLOUD_USERNAME": "<your icloud username>",
        "MCP_CONFIRM_ELICITATION": "<your mcp confirm elicitation>",
        "MCP_CONFIRM_MODE": "<your mcp confirm mode>",
        "MCP_CONFIRM_SECRET": "<your mcp confirm secret>",
        "MCP_CONFIRM_TTL_SECONDS": "<your mcp confirm ttl seconds>"
      }
    }
  }
}

Claude Code

claude mcp add 'apple-icloud-mcp' -- npx -y '[email protected]'

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "apple-icloud-mcp": {
      "args": [
        "-y",
        "[email protected]"
      ],
      "command": "npx",
      "env": {
        "APPLE_DEBUG_LOG": "<your apple debug log>",
        "APPLE_KEY_ID": "<your apple key id>",
        "APPLE_MAPS_KEY_ID": "<your apple maps key id>",
        "APPLE_MAPS_PRIVATE_KEY": "<your apple maps private key>",
        "APPLE_MUSIC_DEVELOPER_TOKEN": "<your apple music developer token>",
        "APPLE_MUSIC_KEY_ID": "<your apple music key id>",
        "APPLE_MUSIC_PRIVATE_KEY": "<your apple music private key>",
        "APPLE_MUSIC_STOREFRONT": "<your apple music storefront>",
        "APPLE_MUSIC_USER_TOKEN": "<your apple music user token>",
        "APPLE_MUSIC_WEB_DEVELOPER_TOKEN": "<your apple music web developer token>",
        "APPLE_MUSIC_WEB_USER_TOKEN": "<your apple music web user token>",
        "APPLE_PRIVATE_KEY": "<your apple private key>",
        "APPLE_PRIVATE_KEY_PATH": "<your apple private key path>",
        "APPLE_REQUEST_TIMEOUT_MS": "<your apple request timeout ms>",
        "APPLE_SERVICES": "<your apple services>",
        "APPLE_STATE_CACHE": "<your apple state cache>",
        "APPLE_TEAM_ID": "<your apple team id>",
        "APPLE_UNITS": "<your apple units>",
        "APPLE_WEATHERKIT_KEY_ID": "<your apple weatherkit key id>",
        "APPLE_WEATHERKIT_PRIVATE_KEY": "<your apple weatherkit private key>",
        "APPLE_WEATHERKIT_SERVICE_ID": "<your apple weatherkit service id>",
        "APPLE_WRITE_MODE": "<your apple write mode>",
        "DISPLAY_TZ": "<your display tz>",
        "ICLOUD_APP_PASSWORD": "<your icloud app password>",
        "ICLOUD_DEFAULT_CALENDAR": "<your icloud default calendar>",
        "ICLOUD_MAIL_ADDRESS": "<your icloud mail address>",
        "ICLOUD_USERNAME": "<your icloud username>",
        "MCP_CONFIRM_ELICITATION": "<your mcp confirm elicitation>",
        "MCP_CONFIRM_MODE": "<your mcp confirm mode>",
        "MCP_CONFIRM_SECRET": "<your mcp confirm secret>",
        "MCP_CONFIRM_TTL_SECONDS": "<your mcp confirm ttl seconds>"
      }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "apple-icloud-mcp": {
      "args": [
        "-y",
        "[email protected]"
      ],
      "command": "npx",
      "env": {
        "APPLE_DEBUG_LOG": "<your apple debug log>",
        "APPLE_KEY_ID": "<your apple key id>",
        "APPLE_MAPS_KEY_ID": "<your apple maps key id>",
        "APPLE_MAPS_PRIVATE_KEY": "<your apple maps private key>",
        "APPLE_MUSIC_DEVELOPER_TOKEN": "<your apple music developer token>",
        "APPLE_MUSIC_KEY_ID": "<your apple music key id>",
        "APPLE_MUSIC_PRIVATE_KEY": "<your apple music private key>",
        "APPLE_MUSIC_STOREFRONT": "<your apple music storefront>",
        "APPLE_MUSIC_USER_TOKEN": "<your apple music user token>",
        "APPLE_MUSIC_WEB_DEVELOPER_TOKEN": "<your apple music web developer token>",
        "APPLE_MUSIC_WEB_USER_TOKEN": "<your apple music web user token>",
        "APPLE_PRIVATE_KEY": "<your apple private key>",
        "APPLE_PRIVATE_KEY_PATH": "<your apple private key path>",
        "APPLE_REQUEST_TIMEOUT_MS": "<your apple request timeout ms>",
        "APPLE_SERVICES": "<your apple services>",
        "APPLE_STATE_CACHE": "<your apple state cache>",
        "APPLE_TEAM_ID": "<your apple team id>",
        "APPLE_UNITS": "<your apple units>",
        "APPLE_WEATHERKIT_KEY_ID": "<your apple weatherkit key id>",
        "APPLE_WEATHERKIT_PRIVATE_KEY": "<your apple weatherkit private key>",
        "APPLE_WEATHERKIT_SERVICE_ID": "<your apple weatherkit service id>",
        "APPLE_WRITE_MODE": "<your apple write mode>",
        "DISPLAY_TZ": "<your display tz>",
        "ICLOUD_APP_PASSWORD": "<your icloud app password>",
        "ICLOUD_DEFAULT_CALENDAR": "<your icloud default calendar>",
        "ICLOUD_MAIL_ADDRESS": "<your icloud mail address>",
        "ICLOUD_USERNAME": "<your icloud username>",
        "MCP_CONFIRM_ELICITATION": "<your mcp confirm elicitation>",
        "MCP_CONFIRM_MODE": "<your mcp confirm mode>",
        "MCP_CONFIRM_SECRET": "<your mcp confirm secret>",
        "MCP_CONFIRM_TTL_SECONDS": "<your mcp confirm ttl seconds>"
      },
      "type": "stdio"
    }
  }
}

Related servers

AITOPIA Verified domain
Generate and edit images, video and audio: 300+ AI models, video tools, voice cloning, transcripts.
Agent Blueprint Verified domain
Measured agent costs, a one-page agent summary check, and an offline access map. No sign-in.
AISTLabs Verified domain
Video, image and audio generation on top AI models for agents, with an AI director built in.
Aisma Verified domain
Edit videos you already shot with plain words and reference photos. Framing and audio stay.
AudioPod AI Verified domain
Audio AI tools: transcription with speakers, stems, noise removal, MIDI, speech, voices and music.
AudioPod AI (core) Verified domain
Transcribe with speaker labels, split stems, remove noise, separate speakers, convert audio to MIDI.