Apple Icloud MCP server

apple-icloud-mcp

A Model Context Protocol server that connects Claude to Apple's web services: Apple Music (your playlists, library and the catalog), iCloud Calendar, Contacts and Mail, Apple Maps, WeatherKit, and the iTunes Search API.

It talks to Apple over the network through Apple's own web APIs and standard protocols (CalDAV, CardDAV, IMAP/SMTP), so — unlike Mac-only Apple integrations such as apple-swift-mcp — it runs anywhere: Linux, Windows, a container, or hosted on mcp-host as a claude.ai connector. The two complement each other: apple-swift-mcp drives the Mac's own apps (Calendar, Reminders, Contacts, Mail, Messages, Notes, Photos, Maps, and Music.app playlists), while apple-icloud-mcp reaches Apple's web services from anywhere and adds the Apple Music catalog, WeatherKit and iTunes.

[!NOTE]

Unofficial. This project is not affiliated with, endorsed by or sponsored by Apple Inc. Apple, iCloud,

Apple Music, Apple Maps and WeatherKit are trademarks of Apple Inc., used here only to name the services it

connects to.

[!WARNING]

AI-developed project. This codebase was entirely built and is actively maintained by

Claude Code. No human has audited the implementation. Review all code

and tool permissions before use.

[!IMPORTANT]

Not yet verified against a live Apple account. Every request shape comes from Apple's documentation or

Apple's own web client and is covered by tests against faithful fakes, but the build environment had no

Apple credentials. The first real run is the real verification — run apple_healthcheck first, and see

docs/APPLE-API.md for what each call relies on.

What you can do

• "Make a playlist called Road Trip 2026 with twenty upbeat 80s songs"
• "Add the top 5 songs from Taylor Swift's latest album to my Workout playlist"
• "Remove duplicates from my Chill playlist and sort it by artist" (web-player mode)
• "What have I been listening to on heavy rotation?" / "Show my Apple Music Replay for this year"
• "What's on my calendar next week?" / "Find me a free hour on Thursday afternoon"
• "Move my dentist appointment to Friday at 3pm"
• "What's Jane's phone number?" / "Add Bob Lee from Acme with bob@acme.com to my contacts"
• "Any unread email from my landlord?" / "Reply to the last message from Sam saying I'll be there"
• "How long will it take to drive to the airport at 5pm?" / "Coffee shops near Union Square"
• "Will it rain in Chicago tomorrow?"
• "Find the podcast Hard Fork and list its latest episodes" / "What are the top albums in the UK right now?"

Services and what each needs

Every service is optional: each one switches on when its credentials are present, and apple_healthcheck tells you which are working.

Shortened. The full README is on GitHub.