Provides tools for interacting with Apple Music, including catalog search, fetching catalog resources, library playlist management, adding tracks to playlists, and retrieving recently played and heavy rotation items.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@apple-music-mcp search the catalog for 'The Beatles' and show top 10 albums"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP server for the Apple Music API: search the catalog, build playlists, manage a library.
Shipped — catalog search is verified; library writes need a user token from npm run auth.
Related MCP server: Sound
Not licensed for reuse.
Built: 2026-04-20
Dev token generation + catalog search: verified working
Library writes (playlists): require user token — run npm run auth once
Already done on Mac Mini:
Apple Developer portal → Identifiers → Media ID (media.com.alexpriest.applemusicmcp)
Keys → MusicKit enabled → downloaded .p8 to keys/AuthKey_68R3STY9CA.p8
.env populated with Team ID, Key ID, Media ID, key path
npm install && npm run build
Registered in ~/.claude.json as "Apple Music"
Writes to the library (creating playlists, etc.) require a Music User Token.
cd ~/Code/tools/apple-music-mcp
npm run authOpen http://localhost:7788, click "Sign in with Apple Music", complete the Apple auth flow. The token is saved to .env automatically and the auth server shuts down.
Restart Claude Code after auth to pick up the new env var.
Tool | Auth | Notes |
| dev only | Full Apple Music catalog |
| dev only | Fetch by type + ID |
| user | User's library |
| user | Library playlists |
| user | By ID — metadata only, no tracks |
| user | Every track in a playlist (auto-pages past Apple's 100/request cap) |
| user | Optional seed tracks |
| user | Append tracks; returns |
| user | Recent tracks |
| user | Most-played |
401 on writes → user token expired or missing; rerun npm run auth.
403 on reads → dev token bad; check Team ID / Key ID / Media ID in .env match the Apple Developer portal.
Developer tokens expire after 180 days but are auto-regenerated from the .p8 on each server start.
Apple returns 204 No Content on successful playlist writes. Handlers must not feed that empty body to
JSON.stringify — it yields undefined, not a string, and the MCP result schema then rejects a write that
actually succeeded. add_to_playlist synthesizes its own success object for this reason.
A library playlist with zero tracks 404s on /tracks rather than returning an empty collection.
get_playlist_tracks treats that as empty.
This server cannot be deployed
iTunes Search MCP — Apple's public catalog search
Full Spotify Web API coverage - albums, artists, playlists, player controls, and more.
Search MusicBrainz artists, releases, works, labels; resolve ISRC/ISWC/barcode; fetch cover art.
Read products, sales, subscribers and offer codes; verify, enable and disable product licenses.