MCP Apple Music
Search Apple Music, manage playlists and browse your library from Claude
- Pricing
- Open source
- Platforms
- CLI, self-hosted, macOS
- Runs
- Locally
- Version
- 1.3.0
- Listing updated
- today
Similar MCP servers
About MCP Apple Music
MCP Apple Music is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.
The setup is heavier than most MCP servers because Apple Music needs two tokens. You sign a developer token locally from a MusicKit private key, which the server renews before it expires, and you obtain a music user token once through a browser authorisation page run by a setup wizard. The user token is stored in a local config file with restricted permissions, and the README says the key never leaves your machine.
You need a paid Apple Developer Program membership to create a MusicKit key and an active Apple Music subscription. The README is explicit that playback control is not possible through Apple's REST API, and points to a separate companion tool for driving a browser tab.
Typical requests combine listening history with catalogue search, such as asking for songs you do not own yet and adding them to a new playlist. It runs over stdio on Python 3.10 or newer and is MIT licensed.
Install
Run in a terminal
claude mcp add mcp-apple-music --env APPLE_TEAM_ID='<APPLE_TEAM_ID>' --env APPLE_KEY_ID='<APPLE_KEY_ID>' --env APPLE_PRIVATE_KEY='<APPLE_PRIVATE_KEY>' --env APPLE_MUSIC_USER_TOKEN='<APPLE_MUSIC_USER_TOKEN>' -- uvx mcp-apple-music-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-apple-music": {
"command": "uvx",
"args": [
"mcp-apple-music-server"
],
"env": {
"APPLE_TEAM_ID": "<APPLE_TEAM_ID>",
"APPLE_KEY_ID": "<APPLE_KEY_ID>",
"APPLE_PRIVATE_KEY": "<APPLE_PRIVATE_KEY>",
"APPLE_MUSIC_USER_TOKEN": "<APPLE_MUSIC_USER_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-apple-music": {
"command": "uvx",
"args": [
"mcp-apple-music-server"
],
"env": {
"APPLE_TEAM_ID": "<APPLE_TEAM_ID>",
"APPLE_KEY_ID": "<APPLE_KEY_ID>",
"APPLE_PRIVATE_KEY": "<APPLE_PRIVATE_KEY>",
"APPLE_MUSIC_USER_TOKEN": "<APPLE_MUSIC_USER_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-apple-music": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-apple-music-server"
],
"env": {
"APPLE_TEAM_ID": "<APPLE_TEAM_ID>",
"APPLE_KEY_ID": "<APPLE_KEY_ID>",
"APPLE_PRIVATE_KEY": "<APPLE_PRIVATE_KEY>",
"APPLE_MUSIC_USER_TOKEN": "<APPLE_MUSIC_USER_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-apple-music": {
"command": "uvx",
"args": [
"mcp-apple-music-server"
],
"env": {
"APPLE_TEAM_ID": "<APPLE_TEAM_ID>",
"APPLE_KEY_ID": "<APPLE_KEY_ID>",
"APPLE_PRIVATE_KEY": "<APPLE_PRIVATE_KEY>",
"APPLE_MUSIC_USER_TOKEN": "<APPLE_MUSIC_USER_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-apple-music": {
"command": "uvx",
"args": [
"mcp-apple-music-server"
],
"env": {
"APPLE_TEAM_ID": "<APPLE_TEAM_ID>",
"APPLE_KEY_ID": "<APPLE_KEY_ID>",
"APPLE_PRIVATE_KEY": "<APPLE_PRIVATE_KEY>",
"APPLE_MUSIC_USER_TOKEN": "<APPLE_MUSIC_USER_TOKEN>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
APPLE_TEAM_IDApple Developer Team IDRequiredAPPLE_KEY_IDApple MusicKit Key IDRequiredAPPLE_PRIVATE_KEYApple MusicKit private key content (ES256, PEM format)RequiredAPPLE_MUSIC_USER_TOKENApple Music user token for personal library accessRequiredAPPLE_STOREFRONTApple Music storefront country code (default: us)
Tools this server provides (15)
Taken from the project documentation; the running server may differ.
- search_catalog
- Searches the Apple Music catalogue
- search_library
- Searches your personal library
- get_library_songs
- Lists saved songs, paginated
- get_library_albums
- Lists saved albums, paginated
- get_library_artists
- Lists library artists
- get_library_playlists
- Lists playlists with IDs
- get_playlist_tracks
- Gets tracks in a playlist
- create_playlist
- Creates a playlist
- add_tracks_to_playlist
- Adds songs to a playlist
- add_to_library
- Saves catalogue items to the library
- get_recently_played
- Shows recently played items
- get_recommendations
- Gets personalised picks
- favorite_song
- Marks a song as favourite
- unfavorite_song
- Removes a song from favourites
- get_song_favorite_status
- Checks which songs are favourited
What it does
- Catalogue search
- Searches songs, albums, artists and playlists in Apple Music.
- Library browsing
- Lists saved songs, albums, artists and playlists, with pagination.
- Playlist creation
- Creates playlists and adds library or catalogue tracks.
- Recommendations
- Returns recently played items and personalised picks.
- Favourites
- Marks or unmarks songs and checks favourite status.
- Local token handling
- Signs developer tokens locally and renews them automatically.
Good for
- Build a playlist from recent listening
- Find albums by an artist and see which you own
- Pick workout tracks and add them to a playlist
- Check which playlists feature an artist most
Pricing
Open source
MIT licence; needs Apple Developer membership (99 USD/year) and Apple Music
MCP Apple Music FAQ
What do I need to use it?
A paid Apple Developer membership to create a MusicKit key, plus an active Apple Music subscription.
Can it play or skip tracks?
No. Playback control is not available through Apple's REST API.
Where is my user token stored?
In a local config file with 600 permissions.
What licence is it?
MIT.
Is MCP Apple Music free?
Yes. MCP Apple Music is open source, so you can use and self-host it for free.
How do I add MCP Apple Music to Claude Code?
Run this command in your terminal: claude mcp add mcp-apple-music --env APPLE_TEAM_ID='<APPLE_TEAM_ID>' --env APPLE_KEY_ID='<APPLE_KEY_ID>' --env APPLE_PRIVATE_KEY='<APPLE_PRIVATE_KEY>' --env APPLE_MUSIC_USER_TOKEN='<APPLE_MUSIC_USER_TOKEN>' -- uvx mcp-apple-music-server
What are the best alternatives to MCP Apple Music?
The closest alternatives to MCP Apple Music are HyperFrames by HeyGen, next-ai-draw-io, mcp-for-blender, ffmpeg-skill and cursor-talk-to-figma-mcp.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.



