applemusic-mcp

MCP server for Apple Music — lets your AI assistant (Claude, Cursor, Cline, Windsurf, or any MCP client) manage playlists, add music, control playback, and browse your library.

Works on macOS, Windows, and Linux.

Access

Access	What it does	Platforms
Developer token — recommended	Full Apple Music API: library, playlists, catalog add, recommendations	macOS · Windows · Linux
Web token	Same	macOS · Windows · Linux
No token	Control the local Music app — play, browse, edit local playlists	macOS

_{Developer token is included with Apple Developer membership (free for App Store developers), valid 6 months — setup. Web token is a free fallback captured by applemusic-mcp signin; it uses Apple's web-player API the same way open-source clients such as Cider and Sidra do.}

Features

Feature	macOS	Cross-platform
List playlists	✓	✓
Browse / search library	✓	✓
Create playlists	✓	✓
Love/dislike tracks	✓	✓
CSV/JSON export	✓	✓
Search catalog	✓	✓
Add songs to library	✓	✓
Add tracks to playlists	✓	✓
Recommendations, charts, radio	✓	✓
Play tracks	✓
Play by URL (album, playlist, song)	✓
Playback control (pause/skip/seek/volume)	✓
Star ratings (1-5)	✓
Remove tracks / delete playlists / folders	✓
Rename / move playlists & folders	✓

Catalog, library, and playlist features run over the Apple Music API — same on every platform (sign in once). Playback is macOS-only for now (native AppleScript control of Music.app); cross-platform browser playback is in progress. Play-from-URL on macOS uses a small AppleScript UI step and needs the screen unlocked + Accessibility permission.

---

Quick Start (macOS)

Requirements: Python 3.10+, Apple Music app with subscription.

No Apple Developer account needed. On macOS, playback and local library features work instantly via AppleScript. To add catalog music to your library/playlists (any platform), sign in once — see Enable catalog features below.

git clone https://github.com/epheterson/applemusic-mcp.git
cd applemusic-mcp
python3 -m venv venv && source venv/bin/activate
pip install -e .

Add to your MCP client config. Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json); Cursor / Cline / Windsurf use the same mcpServers shape — see your client's docs for the file location.

{
  "mcpServers": {
    "Apple Music": {
      "command": "/full/path/to/applemusic-mcp/venv/bin/python",
      "args": ["-m", "applemusic_mcp"]
    }
  }
}

That's it! Restart your client and try: "List my Apple Music playlists" or "Play my favorites playlist"

Windows/Linux users: AppleScript playback requires macOS, but catalog/library/playlist features work cross-platform — just sign in.

---

Enable Catalog Features (sign in once)

Adding catalog music to your library and playlists runs over the Apple Mus

... View full README on GitHub