# Apple Icloud MCP

> Apple Icloud MCP is an open-source MCP server for productivity. Unofficial MCP server for Apple Music, iCloud mail, calendar, contacts, Maps and weather. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Repository:** https://github.com/chrischall/apple-icloud-mcp
- **MCP Registry name:** io.github.chrischall/apple-icloud-mcp
- **Categories:** [productivity](https://ai-powered.com/categories/productivity), [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-18

## About

This server reaches Apple's web services from any operating system, so it runs on Linux, Windows or a container as well as a Mac. Each service switches on only when its credentials are present, and apple_healthcheck reports which ones work.

What each needs differs. Apple Music through the official API needs an Apple Developer key plus a Music User Token. An opt-in web-player mode uses a music.apple.com cookie and unlocks rename, delete and reorder. iCloud Calendar, Contacts and Mail use an Apple ID with an app-specific password over CalDAV, CardDAV and IMAP/SMTP. Apple Maps and WeatherKit use a developer key, and iTunes Search needs nothing.

The README is blunt about risk: it is unofficial, built entirely by Claude Code with no human audit, and not yet verified against a live Apple account. Writes are real, so sending mail or deleting a playlist asks for confirmation first, and APPLE_WRITE_MODE can remove write tools entirely.

## Features

- **Apple Music:** Catalog search, library, playlists, history, recommendations and Replay.
- **iCloud Calendar:** List, search, create, update and delete events and find free time.
- **iCloud Contacts and Mail:** Search and edit contacts; read, send and reply to mail.
- **Apple Maps:** Geocoding, place search, directions and ETAs.
- **WeatherKit:** Current, hourly and daily forecasts and severe-weather alerts.
- **iTunes Search:** Songs, albums, podcasts, apps, books and charts without credentials.
- **Write protection:** Confirmation prompts and APPLE_WRITE_MODE limit what changes.

## Good for

- Build a playlist from a prompt
- Find a free hour next week on your calendar
- Check unread mail from one sender and draft a reply
- Get drive time to the airport at a given hour
- Look up a podcast's latest episodes

## Install

### Claude Code (Terminal)

```sh
claude mcp add apple-icloud-mcp --env APPLE_PRIVATE_KEY='<APPLE_PRIVATE_KEY>' --env APPLE_MUSIC_PRIVATE_KEY='<APPLE_MUSIC_PRIVATE_KEY>' --env APPLE_MAPS_PRIVATE_KEY='<APPLE_MAPS_PRIVATE_KEY>' --env APPLE_WEATHERKIT_PRIVATE_KEY='<APPLE_WEATHERKIT_PRIVATE_KEY>' --env APPLE_MUSIC_DEVELOPER_TOKEN='<APPLE_MUSIC_DEVELOPER_TOKEN>' --env APPLE_MUSIC_USER_TOKEN='<APPLE_MUSIC_USER_TOKEN>' --env APPLE_MUSIC_WEB_USER_TOKEN='<APPLE_MUSIC_WEB_USER_TOKEN>' --env APPLE_MUSIC_WEB_DEVELOPER_TOKEN='<APPLE_MUSIC_WEB_DEVELOPER_TOKEN>' --env ICLOUD_APP_PASSWORD='<ICLOUD_APP_PASSWORD>' --env MCP_CONFIRM_SECRET='<MCP_CONFIRM_SECRET>' -- npx -y apple-icloud-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "apple-icloud-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "apple-icloud-mcp"
      ],
      "env": {
        "APPLE_PRIVATE_KEY": "<APPLE_PRIVATE_KEY>",
        "APPLE_MUSIC_PRIVATE_KEY": "<APPLE_MUSIC_PRIVATE_KEY>",
        "APPLE_MAPS_PRIVATE_KEY": "<APPLE_MAPS_PRIVATE_KEY>",
        "APPLE_WEATHERKIT_PRIVATE_KEY": "<APPLE_WEATHERKIT_PRIVATE_KEY>",
        "APPLE_MUSIC_DEVELOPER_TOKEN": "<APPLE_MUSIC_DEVELOPER_TOKEN>",
        "APPLE_MUSIC_USER_TOKEN": "<APPLE_MUSIC_USER_TOKEN>",
        "APPLE_MUSIC_WEB_USER_TOKEN": "<APPLE_MUSIC_WEB_USER_TOKEN>",
        "APPLE_MUSIC_WEB_DEVELOPER_TOKEN": "<APPLE_MUSIC_WEB_DEVELOPER_TOKEN>",
        "ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>",
        "MCP_CONFIRM_SECRET": "<MCP_CONFIRM_SECRET>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "apple-icloud-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "apple-icloud-mcp"
      ],
      "env": {
        "APPLE_PRIVATE_KEY": "<APPLE_PRIVATE_KEY>",
        "APPLE_MUSIC_PRIVATE_KEY": "<APPLE_MUSIC_PRIVATE_KEY>",
        "APPLE_MAPS_PRIVATE_KEY": "<APPLE_MAPS_PRIVATE_KEY>",
        "APPLE_WEATHERKIT_PRIVATE_KEY": "<APPLE_WEATHERKIT_PRIVATE_KEY>",
        "APPLE_MUSIC_DEVELOPER_TOKEN": "<APPLE_MUSIC_DEVELOPER_TOKEN>",
        "APPLE_MUSIC_USER_TOKEN": "<APPLE_MUSIC_USER_TOKEN>",
        "APPLE_MUSIC_WEB_USER_TOKEN": "<APPLE_MUSIC_WEB_USER_TOKEN>",
        "APPLE_MUSIC_WEB_DEVELOPER_TOKEN": "<APPLE_MUSIC_WEB_DEVELOPER_TOKEN>",
        "ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>",
        "MCP_CONFIRM_SECRET": "<MCP_CONFIRM_SECRET>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "apple-icloud-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "apple-icloud-mcp"
      ],
      "env": {
        "APPLE_PRIVATE_KEY": "<APPLE_PRIVATE_KEY>",
        "APPLE_MUSIC_PRIVATE_KEY": "<APPLE_MUSIC_PRIVATE_KEY>",
        "APPLE_MAPS_PRIVATE_KEY": "<APPLE_MAPS_PRIVATE_KEY>",
        "APPLE_WEATHERKIT_PRIVATE_KEY": "<APPLE_WEATHERKIT_PRIVATE_KEY>",
        "APPLE_MUSIC_DEVELOPER_TOKEN": "<APPLE_MUSIC_DEVELOPER_TOKEN>",
        "APPLE_MUSIC_USER_TOKEN": "<APPLE_MUSIC_USER_TOKEN>",
        "APPLE_MUSIC_WEB_USER_TOKEN": "<APPLE_MUSIC_WEB_USER_TOKEN>",
        "APPLE_MUSIC_WEB_DEVELOPER_TOKEN": "<APPLE_MUSIC_WEB_DEVELOPER_TOKEN>",
        "ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>",
        "MCP_CONFIRM_SECRET": "<MCP_CONFIRM_SECRET>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "apple-icloud-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "apple-icloud-mcp"
      ],
      "env": {
        "APPLE_PRIVATE_KEY": "<APPLE_PRIVATE_KEY>",
        "APPLE_MUSIC_PRIVATE_KEY": "<APPLE_MUSIC_PRIVATE_KEY>",
        "APPLE_MAPS_PRIVATE_KEY": "<APPLE_MAPS_PRIVATE_KEY>",
        "APPLE_WEATHERKIT_PRIVATE_KEY": "<APPLE_WEATHERKIT_PRIVATE_KEY>",
        "APPLE_MUSIC_DEVELOPER_TOKEN": "<APPLE_MUSIC_DEVELOPER_TOKEN>",
        "APPLE_MUSIC_USER_TOKEN": "<APPLE_MUSIC_USER_TOKEN>",
        "APPLE_MUSIC_WEB_USER_TOKEN": "<APPLE_MUSIC_WEB_USER_TOKEN>",
        "APPLE_MUSIC_WEB_DEVELOPER_TOKEN": "<APPLE_MUSIC_WEB_DEVELOPER_TOKEN>",
        "ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>",
        "MCP_CONFIRM_SECRET": "<MCP_CONFIRM_SECRET>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "apple-icloud-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "apple-icloud-mcp"
      ],
      "env": {
        "APPLE_PRIVATE_KEY": "<APPLE_PRIVATE_KEY>",
        "APPLE_MUSIC_PRIVATE_KEY": "<APPLE_MUSIC_PRIVATE_KEY>",
        "APPLE_MAPS_PRIVATE_KEY": "<APPLE_MAPS_PRIVATE_KEY>",
        "APPLE_WEATHERKIT_PRIVATE_KEY": "<APPLE_WEATHERKIT_PRIVATE_KEY>",
        "APPLE_MUSIC_DEVELOPER_TOKEN": "<APPLE_MUSIC_DEVELOPER_TOKEN>",
        "APPLE_MUSIC_USER_TOKEN": "<APPLE_MUSIC_USER_TOKEN>",
        "APPLE_MUSIC_WEB_USER_TOKEN": "<APPLE_MUSIC_WEB_USER_TOKEN>",
        "APPLE_MUSIC_WEB_DEVELOPER_TOKEN": "<APPLE_MUSIC_WEB_DEVELOPER_TOKEN>",
        "ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>",
        "MCP_CONFIRM_SECRET": "<MCP_CONFIRM_SECRET>"
      }
    }
  }
}
```

## Tools

- `apple_healthcheck`: Reports which Apple services are configured and working.

## FAQ

### Does it need a Mac?

No, it runs on Linux, Windows or in a container.

### What does it cost?

The server is free; Apple Music official access needs an Apple Developer Program membership ($99/yr) and an Apple Music subscription. Maps is free up to 25,000 calls a day and WeatherKit up to 500,000 a month.

### Is it affiliated with Apple?

No. The README states it is unofficial.

### How do I check it works?

Run apple_healthcheck first.

### Which Node version?

Node.js 22 or later.

### Is Apple Icloud MCP free?

Yes. Apple Icloud MCP is open source, so you can use and self-host it for free.

### How do I add Apple Icloud MCP to Claude Code?

Run this command in your terminal: claude mcp add apple-icloud-mcp --env APPLE_PRIVATE_KEY='<APPLE_PRIVATE_KEY>' --env APPLE_MUSIC_PRIVATE_KEY='<APPLE_MUSIC_PRIVATE_KEY>' --env APPLE_MAPS_PRIVATE_KEY='<APPLE_MAPS_PRIVATE_KEY>' --env APPLE_WEATHERKIT_PRIVATE_KEY='<APPLE_WEATHERKIT_PRIVATE_KEY>' --env APPLE_MUSIC_DEVELOPER_TOKEN='<APPLE_MUSIC_DEVELOPER_TOKEN>' --env APPLE_MUSIC_USER_TOKEN='<APPLE_MUSIC_USER_TOKEN>' --env APPLE_MUSIC_WEB_USER_TOKEN='<APPLE_MUSIC_WEB_USER_TOKEN>' --env APPLE_MUSIC_WEB_DEVELOPER_TOKEN='<APPLE_MUSIC_WEB_DEVELOPER_TOKEN>' --env ICLOUD_APP_PASSWORD='<ICLOUD_APP_PASSWORD>' --env MCP_CONFIRM_SECRET='<MCP_CONFIRM_SECRET>' -- npx -y apple-icloud-mcp

### What are the best alternatives to Apple Icloud MCP?

The closest alternatives to Apple Icloud MCP are TrendRadar, Ha MCP, Concord MCP, Getmitra and note1.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [TrendRadar](https://ai-powered.com/mcp/trendradar): TrendRadar is an open-source MCP server for communication.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [Getmitra](https://ai-powered.com/mcp/getmitra): Getmitra is an MCP server for communication.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [Discord](https://ai-powered.com/mcp/discord-2): Discord is a freemium MCP server for communication.
- [InviteKit Calendar Files](https://ai-powered.com/mcp/invitekit-calendar-files): InviteKit Calendar Files is an MCP server for files and documents.
- [Zoom](https://ai-powered.com/mcp/zoom): Zoom is a freemium MCP server for communication.

---
Source: https://ai-powered.com/mcp/apple-icloud-mcp
