Overview
What is Apple Music Mcp?
Apple Music Mcp is an MCP (Model Context Protocol) server that gives Claude full access to your Apple Music account — you can search the catalog, browse your personal library, manage playlists, and explore your listening history and recommendations. It is designed for Claude Desktop users with an active Apple Music subscription and an Apple Developer account.
How to use Apple Music Mcp?
Install Python 3.10+ and uv (recommended) or pip, clone the repository, run the one-time setup wizard (uv run mcp-apple-music-setup) to authorize via Apple’s MusicKit JS OAuth, then add the server to your Claude Desktop config with the uv run command pointing to the project directory. After restarting Claude, all 11 tools appear in the toolbar.
Key features of Apple Music Mcp
- Search Apple Music catalog (songs, albums, artists, playlists)
- Search your personal library
- List library songs, albums, artists, and playlists
- Get tracks in a specific playlist
- Create new playlists
- Add tracks to playlists (library or catalog)
- View recently played albums, playlists, and stations
- Receive personalised Apple Music recommendations
Use cases of Apple Music Mcp
- Ask Claude to recommend songs based on your listening history and create a new playlist with them.
- Search for a specific artist’s albums and see which ones you already own.
- List all your playlists and have Claude analyse which artists appear most often.
- Create a mood-based playlist (e.g., “Rainy Sunday”) with tracks from your library or the catalog.
FAQ from Apple Music Mcp
What are the prerequisites for using Apple Music Mcp?
Python 3.10+, uv (or pip), an Apple Developer account (free tier is fine) with a MusicKit key, and an active Apple Music subscription.
How are the two tokens handled?
The Developer Token is a JWT signed locally with your .p8 private key and auto‑renewed before expiry; your key never leaves your machine. The Music User Token is obtained once via browser OAuth during the setup wizard and stored locally at ~/.config/mcp-apple-music/config.json (permissions 600).
Does Apple Music Mcp support playback control (play/pause/skip)?
No. Playback control is not available via Apple’s REST API; it requires native MusicKit frameworks or MusicKit JS in a browser context.
What transport does the server use?
The server uses MCP over stdio, launched via uv run from the Claude Desktop configuration.
Where is my token data stored and is it secure?
Your Music User Token is stored in ~/.config/mcp-apple-music/config.json with file permissions 600. The .p8 private key for the Developer Token stays on your machine and is never transmitted.
