Apple Music MCP Server

Apple Music MCP Server

An MCP (Model Context Protocol) server that integrates with Apple Music, allowing Claude and other MCP clients to search the catalog, manage playlists, and access your library.

Features

• Search the Apple Music catalog (songs, albums, artists, playlists)
• List your playlists and browse their tracks
• Create new playlists with optional initial tracks
• Add tracks to existing playlists
• Browse your library songs
• View recently played tracks
• Get personalized recommendations

Prerequisites

• Node.js 18+
• An Apple Developer Program membership
• A MusicKit identifier and private key

Apple Developer Setup

1. Create a MusicKit Identifier

1. Go to Apple Developer > Certificates, Identifiers & Profiles
2. Click + to register a new identifier
3. Select MusicKit IDs (or Media IDs)
4. Enter a description (e.g., "MCP Server") and an identifier (e.g., com.yourname.musicmcp)
5. Click Continue and Register

2. Create a MusicKit Private Key

1. Go to Apple Developer > Keys
2. Click + to create a new key
3. Name it (e.g., "MusicKit MCP Key")
4. Check MusicKit and configure it with your MusicKit identifier
5. Click Continue and Register
6. Download the .p8 file (you can only download it once!)
7. Note the Key ID shown on the page

3. Find Your Team ID

Your Team ID is visible at the top right of the Apple Developer portal, or under Membership Details.

Installation

git clone <this-repo>
cd AppleMusicMCP
npm install
npm run build

Configuration

The server is configured via environment variables:

Authorization

Before using library features (playlists, library songs, recommendations), you need to authorize with your Apple Music account:

APPLE_MUSIC_TEAM_ID=YOUR_TEAM_ID \
APPLE_MUSIC_KEY_ID=YOUR_KEY_ID \
APPLE_MUSIC_PRIVATE_KEY_PATH=/path/to/AuthKey.p8 \
node dist/index.js auth

This will:

1. Open your browser to a local authorization page
2. You click "Authorize with Apple Music" and sign in with your Apple ID
3. The Music User Token is captured and stored in ~/.apple-music-mcp/tokens.json
4. The token is valid for approximately 6 months

Note: Catalog search works without authorization. Only library/personal features require it.

Adding to Claude Desktop

Add this to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "apple-music": {
      "command": "node",
      "args": ["/absolute/path/to/AppleMusicMCP/dist/index.js"],
      "env": {
        "APPLE_MUSIC_TEAM_ID": "YOUR_TEAM_ID",
        "APPLE_MUSIC_KEY_ID": "YOUR_KEY_ID",
        "APPLE_MUSIC_PRIVATE_KEY_PATH": "/absolute/path/to/AuthKey_XXXXXXXX.p8",
        "APPLE_MUSIC_STOREFRONT": "us"
      }
    }
  }
}

Adding to Claude Code

Add to your Claude Code settings (.claude/settings.json or global settings):

{
  "mcpServers": {
    "apple-music": {
      "command": "node",
      "args": ["/absolute/path/to/AppleMusicMCP/dist/index.js"],
      "env": {
        "APPLE_MUSIC_TEAM_ID": "YOUR_TEAM_ID",
        "APPLE_MUSIC_KEY_ID": "YOUR_KEY_ID",
        "APPLE_MUSIC_PRIVATE_KEY_PATH": "/absolute/path/to/AuthKey_XXXXXXXX.p8"
      }
    }
  }
}

Available Tools

`search_music`

Search the Apple Music catalog.

• query (string, required): Search term
• types (array, optional): ["songs", "albums", "artists", "playlists"] (default: songs, albums, artists)
• limit (number, optional): 1-25 results per type (default: 10)
• storefront (string, optional): Country code

`get_user_playlists`

List your playlists.

• limit (number, optional): 1-100 (default: 25)
• offset (number, optional): Pagination offset

`get_playlist_tracks`

Get tracks from a playlist.

• playlist_id (string, required): Playlist ID
• limit (number, optional): 1-100 (default: 100)
• offset (number, optional): Pagination offset

`create_playlist`

Create a new playlist.

• name (string, required): Playlist name
• description (string, optional): Playlist description
• track_ids (string[], optional): Song IDs to a