# MCP Apple Music

> MCP Apple Music is an open-source MCP server for design and media. Search Apple Music, manage playlists and browse your library from Claude. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS
- **Repository:** https://github.com/cifero74/mcp-apple-music
- **MCP Registry name:** io.github.Cifero74/mcp-apple-music
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media), [events and entertainment](https://ai-powered.com/categories/events-and-entertainment)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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

## 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.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [next-ai-draw-io](https://ai-powered.com/mcp/next-ai-draw-io-2): next-ai-draw-io is an open-source MCP server for ai models and llm tooling.
- [mcp-for-blender](https://ai-powered.com/mcp/mcp-for-blender): mcp-for-blender is an open-source MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [cursor-talk-to-figma-mcp](https://ai-powered.com/mcp/cursor-talk-to-figma-mcp): cursor-talk-to-figma-mcp is an open-source MCP server for design and media.
- [Design Feeds](https://ai-powered.com/mcp/design-feeds): Design Feeds is a freemium MCP server for design and media.
- [Dostuff](https://ai-powered.com/mcp/dostuff): Dostuff is a freemium MCP server for events and entertainment.
- [Zovo Palette Lab](https://ai-powered.com/mcp/zovo-palette-lab): Zovo Palette Lab is an MCP server for design and media.

---
Source: https://ai-powered.com/mcp/mcp-apple-music
