Cifero74/mcp-apple-music

mcp-name: io.github.Cifero74/mcp-apple-music
An **MCP (Model Context Protocol) server** that gives Claude full access to your Apple Music account — search the catalog, browse your personal library, manage playlists, and explore your listening history and recommendations.
> **Ask Claude things like:**
> - *"Based on what I've been listening to lately, recommend 15 songs I don't have yet and add them to a new playlist"*
> - *"Show me all my playlists and tell me which artists appear most"*
> - *"Search for albums by Nick Cave and add my three favourites to a playlist called Dark Picks"*
---
Features
| Tool | Description |
|---|---|
| search_catalog | Search Apple Music catalog (songs, albums, artists, playlists) |
| search_library | Search within your personal library |
| get_library_songs | List songs saved in your library (paginated) |
| get_library_albums | List albums in your library (paginated) |
| get_library_artists | List artists in your library |
| get_library_playlists | List all your playlists with IDs |
| get_playlist_tracks | Get tracks inside a specific playlist |
| create_playlist | Create a new playlist |
| add_tracks_to_playlist | Add songs to a playlist (library or catalog tracks) |
| get_recently_played | See recently played albums/playlists/stations |
| get_recommendations | Get personalised Apple Music picks |
| favorite_song | Mark a catalog song as favorite (star) |
| unfavorite_song | Remove a catalog song from favorites |
| get_song_favorite_status | Check which catalog songs are favorited |
---
Requirements
- Python 3.10+
- uv (recommended) or pip
- A paid **Apple Developer Program** membership (99 USD/year) to create a MusicKit key. The free Apple Developer account can't create MusicKit keys.
- An active **Apple Music subscription**
---
Setup
1. Create a MusicKit Key
1. Go to developer.apple.com → **Certificates, Identifiers & Profiles**
2. Under **Keys**, click **+** to create a new key
3. Give it any name, enable **MusicKit**, and click **Continue → Register**
4. **Download** the .p8 file — you can only download it once, keep it safe!
5. Note your **Key ID** (e.g. ABC123DEF4) and your **Team ID** (found under *Membership Details*)
> ⚠️ The Key ID is the alphanumeric code shown next to the key name — **not** the filename of the .p8 file.
2. Clone and install
3. Run the one-time setup wizard
The wizard will ask for your **Team ID**, **Key ID**, and the path to your .p8 file. It then opens a browser page where you click **"Authorise Apple Music"** — this uses Apple's official MusicKit JS to obtain your Music User Token, which is stored securely at ~/.config/mcp-apple-music/config.json (file permissions: 600).
4. Add to Claude Desktop
Open your Claude Desktop config:
**macOS:** ~/Library/Application Support/Claude/claude_desktop_config.json
Restart Claude Desktop — you should see the apple-music tools available in the toolbar.