apple-icloud-mcp

Name: apple-icloud-mcp
Author: chrischall

Community

MCP server by chrischall · updated 4 days ago · ★ 0 · 295 downloads a week

Score 77

Unofficial: Apple Music, iCloud Calendar/Contacts/Mail, Apple Maps and WeatherKit, no Mac needed apple-icloud-mcp is a community project by chrischall, not verified by a company domain.

Install Add to Cursor Add to VS Code GitHub

Yours? Claim it

Works withClaude Code Claude Desktop Cursor Codex Gemini CLI VS Code Windsurf Antigravity CLI

Maintenance

Last commit 4 days ago

Licence

MIT: permissive, fine for commercial use

Quality

Clear description, published package or server URL, original repository

Security

No risky patterns in the files we checked

What you need

Setting	Needed	What it is
`APPLE_TEAM_ID`Environment variable	Optional	Your Apple Developer Team ID (10 characters). Needed for Apple Music (official API), Apple Maps and WeatherKit.
`APPLE_KEY_ID`Environment variable	Optional	Key ID of a private key created in Certificates, Identifiers & Profiles → Keys with Media Services (MusicKit), MapKit JS and/or WeatherKit enabled.
`APPLE_PRIVATE_KEY`Environment variable, secret	Optional	Contents of that key's .p8 file (PEM; one-line values with \n escapes and base64 are accepted).
`APPLE_PRIVATE_KEY_PATH`Environment variable	Optional	Local installs only: a path to the .p8 file instead of APPLE_PRIVATE_KEY.
`APPLE_MUSIC_KEY_ID`Environment variable	Optional	Optional per-service override of APPLE_KEY_ID for Apple Music (pair with APPLE_MUSIC_PRIVATE_KEY).
`APPLE_MUSIC_PRIVATE_KEY`Environment variable, secret	Optional	Optional per-service override of APPLE_PRIVATE_KEY for Apple Music.
`APPLE_MAPS_KEY_ID`Environment variable	Optional	Optional per-service override of APPLE_KEY_ID for Apple Maps.
`APPLE_MAPS_PRIVATE_KEY`Environment variable, secret	Optional	Optional per-service override of APPLE_PRIVATE_KEY for Apple Maps.
`APPLE_WEATHERKIT_KEY_ID`Environment variable	Optional	Optional per-service override of APPLE_KEY_ID for WeatherKit.
`APPLE_WEATHERKIT_PRIVATE_KEY`Environment variable, secret	Optional	Optional per-service override of APPLE_PRIVATE_KEY for WeatherKit.
`APPLE_WEATHERKIT_SERVICE_ID`Environment variable	Optional	WeatherKit only: the Services ID registered for WeatherKit (e.g. com.example.weather).
`APPLE_MUSIC_DEVELOPER_TOKEN`Environment variable, secret	Optional	Optional: a pre-minted Apple Music developer token (JWT) instead of signing one from the key above.
`APPLE_MUSIC_USER_TOKEN`Environment variable, secret	Optional	Music User Token for your library (official API), from a one-time MusicKit sign-in: `npx apple-icloud-mcp music-auth`. Without the Apple Developer key, ask the owner for a developer token (music-auth --print-developer-token) and run it with
`APPLE_MUSIC_WEB_USER_TOKEN`Environment variable, secret	Optional	Opt-in web-player mode (no developer account needed; unlocks rename/delete/remove/reorder): the media-user-token cookie from a signed-in music.apple.com tab.
`APPLE_MUSIC_WEB_DEVELOPER_TOKEN`Environment variable, secret	Optional	Optional override for the web-player developer token (normally read automatically from music.apple.com).
`APPLE_MUSIC_STOREFRONT`Environment variable	Optional	Two-letter Apple Music storefront (e.g. us, gb). Default: your account's storefront, else us.
`ICLOUD_USERNAME`Environment variable	Optional	Your Apple ID email, for iCloud Calendar, Contacts and Mail.
`ICLOUD_APP_PASSWORD`Environment variable, secret	Optional	An app-specific password from appleid.apple.com → Sign-In and Security → App-Specific Passwords (NOT your Apple ID password).
`ICLOUD_MAIL_ADDRESS`Environment variable	Optional	Your @icloud.com address, only if your Apple ID email is not an iCloud address (needed for Mail).
`ICLOUD_DEFAULT_CALENDAR`Environment variable	Optional	Calendar new events go to when none is named (default: the first writable event calendar).

From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.

Install apple-icloud-mcp

Built from the published package, never by AI

claude mcp add apple-icloud-mcp -- npx -y apple-icloud-mcp

Run in your terminal. Add --scope user to use it in every project.

Step-by-step: install apple-icloud-mcp in Claude Code

{
  "mcpServers": {
    "apple-icloud-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "apple-icloud-mcp"
      ]
    }
  }
}

Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.

Step-by-step: install apple-icloud-mcp in Claude Desktop

{
  "mcpServers": {
    "apple-icloud-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "apple-icloud-mcp"
      ]
    }
  }
}

Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).

Step-by-step: install apple-icloud-mcp in Cursor

{
  "servers": {
    "apple-icloud-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "apple-icloud-mcp"
      ]
    }
  }
}

Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".

Step-by-step: install apple-icloud-mcp in VS Code

codex mcp add apple-icloud-mcp -- npx -y apple-icloud-mcp

Step-by-step: install apple-icloud-mcp in Codex

{
  "mcpServers": {
    "apple-icloud-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "apple-icloud-mcp"
      ]
    }
  }
}

Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).

Step-by-step: install apple-icloud-mcp in Antigravity CLI

gemini mcp add apple-icloud-mcp npx -y apple-icloud-mcp

Gemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.

Step-by-step: install apple-icloud-mcp in Gemini CLI

MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the apple-icloud-mcp block.

Weekly newsletter

Like apple-icloud-mcp? Get the best new MCP servers every week

The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.

Security check

No download-and-run commands, hidden instructions or signs of sending keys out were found.

Checked automatically: README.md, package.json. This looks for known risky patterns and is not a full audit. How grades work

Alternatives to apple-icloud-mcp

All alternatives →

Agent-Native CalendarBuilderIO

Agent-Native Google Calendar - manage events, sync, and public booking

AAA Remote 7.4k

Agent-Native ClipsBuilderIO

Screen recording, meeting notes, and voice dictation - all with AI

AAA Remote 7.4k

kaneousekaneo

Official MCP server for Kaneo: manage tasks, projects, and labels from Claude and other MCP clients

AAA Local 9.5k

Agent Afk griffinwork40

Open-source coding-agent harness you can actually change — own the loop (prompts, gates, routing, skills, terminal states), use any model, run long tasks while you're away.

AAB Local 65k/wk

Korean Law MCP chrisryugj

법제처 42개 API → 9개 MCP 도구. 법령·판례·조례·조약 + 다단계 리서치(legal_research, 8 task) + 정밀분석(legal_analysis: 인용검증·판례생사·행위시법·영향그래프) + 시점 비교(time_travel) + 상황별 5단계 안내(action_plan) + 국세청 해석례(nts)

AAA Local 2.8k/wk

Anki MCP Server ankimcp

MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.

AAA Local 703/wk

apple-icloud-mcp vs Agent-Native Calendar apple-icloud-mcp vs Agent-Native Clips apple-icloud-mcp vs kaneo

apple-icloud-mcp: common questions

How do I install apple-icloud-mcp?

In Claude Code run claude mcp add apple-icloud-mcp -- npx -y apple-icloud-mcp. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.

Is apple-icloud-mcp the official server?

apple-icloud-mcp is a community project by chrischall, not verified by a company domain.

Is apple-icloud-mcp free?

The code is published under the MIT licence. The service it connects to may have its own pricing.

Is apple-icloud-mcp safe to use?

It scores 77 of 100. Grades: maintenance A, licence A, quality C. Security check: grade A, no risky patterns found in the files checked. Review the code before you install. How grades work.

What are alternatives to apple-icloud-mcp?

Similar MCP servers: Agent-Native Calendar, Agent-Native Clips, kaneo, Agent Afk.

Does apple-icloud-mcp work with ChatGPT?

Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.