Log inSubmit server
Apple Icloud MCP logo

Apple Icloud MCP

Connects AI agents to Apple Music, iCloud services, Apple Maps, WeatherKit, and iTunes without requiring a Mac.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Apple Icloud MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "apple-icloud-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "apple-icloud-mcp"
      ],
      "env": {
        "ICLOUD_USERNAME": "YOUR_VALUE_HERE",
        "ICLOUD_APP_PASSWORD": "YOUR_VALUE_HERE",
        "ICLOUD_MAIL_ADDRESS": "YOUR_VALUE_HERE",
        "DISPLAY_TZ": "YOUR_VALUE_HERE",
        "APPLE_WRITE_MODE": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 37 tools correctly (21d ago).

Overview

The apple-icloud-mcp MCP server connects AI agents to Apple web services, including Apple Music, iCloud Calendar, Contacts, Mail, Apple Maps, WeatherKit, and iTunes. It communicates over network APIs and standard protocols such as CalDAV, CardDAV, and IMAP/SMTP, so it can run on Linux, Windows, containers, or hosted environments. Use it when an agent needs to search Apple data, manage calendars or contacts, work with music libraries, query locations, or retrieve weather information without controlling a Mac. Each service is optional and becomes available when its required credentials are configured.

Use cases

  • Search Apple Music catalogs and personal libraries
  • Create playlists and add tracks
  • Find free time and manage calendar events
  • Search iCloud contacts and contact groups
  • Query Apple locations and weather services

Key features

  • Apple Music catalog, library, playlist, and history tools
  • iCloud Calendar event management and free-time search
  • iCloud Contacts search and retrieval
  • Apple Maps geocoding, directions, and ETAs
  • WeatherKit forecasts and alerts
  • Optional iCloud Mail and iTunes service access

Tools37

What Apple Icloud MCP lets your agent do. Expand a tool for its parameters.

Verified live~16.2k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

9/9 checks healthy over the last 37d

What it can do

From the 37 tools this server returned when we ran it; 37 declare their own safety hints.

Handles credentials · 9Makes network requests · 37Read-only tools · 37
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age24 days
Maintainers1

Observed 2026-10-22 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 14d ago via OSV.dev · apple-icloud-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads1.3kPackage downloads in the last 30 days.
Last commit4d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed37Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Apple Icloud MCP works

What apple-icloud-mcp does

The apple-icloud-mcp MCP server exposes Apple web services to an MCP-compatible client. Its coverage includes Apple Music, iCloud Calendar, iCloud Contacts, iCloud Mail, Apple Maps, WeatherKit, and the iTunes Search API. The server is intended for access to the Apple accounts whose credentials are supplied; it does not provide access to other users' data.

Apple Music capabilities include catalog and library search, catalog lookups, charts, playlists, folders, listening history, recommendations, Replay data, ratings, favorites, and library changes such as creating playlists or adding tracks. Calendar tools can list, search, read, create, update, and delete events, including recurring events, and can identify free time within configurable working hours.

The README additionally documents iCloud Mail operations, Apple Maps geocoding and directions, WeatherKit forecasts and alerts, and iTunes searches and charts. Availability depends on the credentials and service configuration for each area.

How it works

The apple-icloud-mcp MCP server uses Apple's network-facing services rather than macOS applications. Calendar access uses CalDAV, Contacts uses CardDAV, and Mail uses IMAP/SMTP. Apple Music uses its official API for catalog and account features; an optional web-player mode uses a browser session cookie for additional playlist-management operations. Apple Maps and WeatherKit use Apple developer services, while iTunes uses Apple's search and chart endpoints.

Requests run in the server process and operate on the Apple account associated with that process. Write operations have real effects: calendar invitations can send email, mail actions can send messages, and deleting playlists or contacts removes data. The project recommends running the health-check tool first because the implementation had not been verified against a live Apple account in the documented build environment.

Setup and configuration

Node.js 22 or later is required. The package can be started with npx -y apple-icloud-mcp, installed from the Claude Desktop bundle, or built from source with npm. Claude Code can register it as an MCP server using the claude mcp add command. A source setup uses npm install, npm run build, and the provided environment-file template.

Calendar, Contacts, and Mail use an Apple ID plus an app-specific password. Set ICLOUD_USERNAME and ICLOUD_APP_PASSWORD; Mail may also require ICLOUD_MAIL_ADDRESS when the Apple ID is not an iCloud or me.com address. The normal Apple ID password is not accepted for these services, and changing the Apple ID password revokes existing app-specific passwords.

Apple Music's official API requires an Apple Developer key and Music User Token. Apple Maps requires an Apple Developer key. WeatherKit requires an Apple Developer key and Services ID. DISPLAY_TZ can configure the display time zone.

Tools and capabilities

The documented tool set supports:

  • Checking configured and reachable Apple services with apple_healthcheck.
  • Searching, reading, and modifying Apple Music catalogs, libraries, playlists, folders, ratings, favorites, history, and recommendations.
  • Listing, searching, creating, updating, deleting, and scheduling around iCloud Calendar events.
  • Searching contacts, retrieving contact records, and listing contact groups.
  • Using Apple Maps, WeatherKit, iCloud Mail, and iTunes features described by the project when their credentials are present.

Limitations and notes

The project is unofficial and not affiliated with Apple. Apple terms govern use, and the README advises personal use, careful credential handling, and avoiding bulk extraction. Apple Music web-player mode is off by default and may be blocked because it relies on a private web API.

The codebase is described as AI-developed and not human-audited. Review the implementation and tool permissions before deployment. Service credentials are optional, but unavailable credentials disable the related service. Repeated failed sign-ins may lead to account lockout, and Apple rate limits may apply. The project also notes that write actions require confirmation and can be restricted through APPLE_WRITE_MODE.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Apple Icloud MCP

apple-icloud-mcp is an MCP server that connects AI clients to Apple web services, including Apple Music, iCloud Calendar, Contacts, Mail, Apple Maps, WeatherKit, and iTunes. Its main tools search and manage music, calendar events, and contacts, while other documented services become available when their credentials are configured.

Install it with Node.js 22 or later using `npx -y apple-icloud-mcp`, add that command to an MCP client configuration, or install the Claude Desktop bundle. From source, clone the repository, run `npm install`, build with `npm run build`, and configure the required environment variables.

Credentials depend on the services you enable. iCloud Calendar, Contacts, and Mail use an Apple ID and app-specific password. Apple Music requires an Apple Developer key and Music User Token, Apple Maps requires an Apple Developer key, and WeatherKit requires an Apple Developer key plus Services ID.

Yes, it is designed to run without a Mac by using Apple's web APIs and standard network protocols. It accesses Apple web services rather than macOS applications, so service credentials and network access are still required.

Related MCP servers

All in Workplace & Productivity All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewApple Icloud MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/apple-icloud-mcp?style=directory)](https://allmcps.com/mcp/apple-icloud-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/apple-icloud-mcp"><img src="https://allmcps.com/api/badge/apple-icloud-mcp?style=directory" alt="Apple Icloud MCP on AllMCPs" /></a>