# applemusic-mcp

Connects Apple Music to your AI assistant for playlist management, playback controls, and catalog searches. Runs on macOS, Windows, and Linux with an active subscription.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 121
- Author: epheterson
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/epheterson/applemusic-mcp
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/applemusic-mcp

## What it does

The server links your coding assistant with Apple Music via seven focused tools. The model can queue songs, adjust volume, trigger AirPlay output, and build new playlists. It queries the local desktop player or the online service API.

Access scopes are regulated with the `--level` flag. The base `music` tier interacts strictly with macOS Music.app without touching the network. Switching to `api` or `web` brings catalog access and recommendation feeds to Windows and Linux. Queue management relies on a desktop browser session. On non-Mac systems, Google Chrome is mandatory.

Running the tool requires Python 3.10 or newer. Without running `applemusic-mcp login`, cloud catalog actions will fail outside macOS.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add applemusic-mcp -- uvx applemusic-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from applemusic-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add applemusic-mcp -- uvx applemusic-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from applemusic-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "applemusic-mcp": {
            "command": "uvx",
            "args": [
                "applemusic-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from applemusic-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "applemusic-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "applemusic-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from applemusic-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add applemusic-mcp uvx applemusic-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from applemusic-mcp <command>

## When to use it
- Control playback, volume, and shuffle from chat
- Find tracks across the catalog and save them to the library
- Build custom playlists based on moods or genres
- Inspect and reorder the Up Next queue

## Example prompts
- Create an upbeat 90s alternative playlist and name it Road Trip.
- Shuffle my workout playlist and add Bohemian Rhapsody to the queue.
- Show what is currently playing and list the upcoming songs.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md