Skip to content
MCP server

MCP Apple Music

Search Apple Music, manage playlists and browse your library from Claude

Runs locallyStatus and history
Install
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-server

Add 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 IDRequired
  • APPLE_KEY_IDApple MusicKit Key IDRequired
  • APPLE_PRIVATE_KEYApple MusicKit private key content (ES256, PEM format)Required
  • APPLE_MUSIC_USER_TOKENApple Music user token for personal library accessRequired
  • APPLE_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.

How AIPoweredBot checks servers