Apple Music Playlist Curator MCP server

Apple Music MCP Curator

<!-- mcp-name: io.github.Z-Han-Z/apple-music-playlists -->

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Português do Brasil | Deutsch | Français

Deep playlist curation for Apple Music: describe a feeling, scene, era, tension, or narrative arc; your agent turns it into a catalog-grounded selection whose versions, pacing, and transitions hold together as a listening experience.

Pure Python standard library — no pip install required to run, and no Apple Developer Program membership needed. Requires Python 3.10+ and works on Windows / macOS / Linux.

The primary interface is the local am-mcp stdio server. The language model already running in your MCP client interprets the brief and chooses candidates; this project searches the Apple Music catalog, resolves exact tracks, and performs account operations. There is no bundled model, LLM API key, artist list, or fixed theme. The CLI remains available for login, diagnostics, scripting, audits, and advanced sequencing.

understand  →  curate  →  ground  →  shape the arc  →  dry-run  →  create

Why this project

era, cultural context, contrast, and the role of each song. It is not reduced to a handful of user-supplied sliders or an opaque theme-fit number.

• The brief stays semantic. The host LLM reasons directly about imagery, mood, lyrical angle,

energy, valence, and loudness can then diagnose transitions or refine order inside narrative blocks without overriding the musical idea.

• Selection and sequencing stay separate. The model decides what belongs; measured BPM, key,

artists, and suspicious live/remastered versions before the dry run and final create step.

• Every candidate is grounded. Catalog resolution catches missing tracks, duplicates, wrong

inform curation without silently becoming an algorithmic definition of the user's taste.

• Listening evidence remains evidence. Replay history, recent plays, dates, and play counts can

app config, and there is no bundled model, telemetry service, or extra LLM API key.

• Local and private by design. The server runs on your machine; credentials stay in the local

Cordis/DSH, Harness, and other clients that can launch a local stdio server.

• Portable MCP stdio. Works with Codex, Claude, Cursor, VS Code/Copilot, Gemini CLI, Windsurf,

Quick start

Recommended — install the MCP stdio service:

Shortened. The full README is on GitHub.