Skip to main content
Glama
alexpriest

apple-music-mcp

by alexpriest
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

apple-music-mcp

An MCP server for the Apple Music API: search the catalog, build playlists, manage a library.

Status

Shipped — catalog search is verified; library writes need a user token from npm run auth.

Related MCP server: Apple Music

License

Not licensed for reuse.

Status

  • Built: 2026-04-20

  • Dev token generation + catalog search: verified working

  • Library writes (playlists): require user token — run npm run auth once

Setup

Already done on Mac Mini:

  1. Apple Developer portal → Identifiers → Media ID (media.com.alexpriest.applemusicmcp)

  2. Keys → MusicKit enabled → downloaded .p8 to keys/AuthKey_68R3STY9CA.p8

  3. .env populated with Team ID, Key ID, Media ID, key path

  4. npm install && npm run build

  5. Registered in ~/.claude.json as "Apple Music"

Authorizing the user token

Writes to the library (creating playlists, etc.) require a Music User Token.

cd ~/Code/tools/apple-music-mcp
npm run auth

Open http://localhost:7788, click "Sign in with Apple Music", complete the Apple auth flow. The token is saved to .env automatically and the auth server shuts down.

Restart Claude Code after auth to pick up the new env var.

Tools

Tool

Auth

Notes

search_catalog

dev only

Full Apple Music catalog

get_catalog_resource

dev only

Fetch by type + ID

search_library

user

User's library

list_playlists

user

Library playlists

get_playlist

user

By ID — metadata only, no tracks

get_playlist_tracks

user

Every track in a playlist (auto-pages past Apple's 100/request cap)

create_playlist

user

Optional seed tracks

add_to_playlist

user

Append tracks; returns {added, playlist_id}

recently_played

user

Recent tracks

heavy_rotation

user

Most-played

Troubleshooting

  • 401 on writes → user token expired or missing; rerun npm run auth.

  • 403 on reads → dev token bad; check Team ID / Key ID / Media ID in .env match the Apple Developer portal.

  • Developer tokens expire after 180 days but are auto-regenerated from the .p8 on each server start.

  • Apple returns 204 No Content on successful playlist writes. Handlers must not feed that empty body to JSON.stringify — it yields undefined, not a string, and the MCP result schema then rejects a write that actually succeeded. add_to_playlist synthesizes its own success object for this reason.

  • A library playlist with zero tracks 404s on /tracks rather than returning an empty collection. get_playlist_tracks treats that as empty.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • am-mcp

    Z-Han-Z
    A
    license
    A
    quality
    A
    maintenance
    Enables MCP clients to manage Apple Music playlists end-to-end, including search, playlist creation and editing, metadata and flow auditing, track ordering optimization, and listening statistics, without an Apple Developer account.
    14
    65 PyPI
    2
    MIT

  • Apple Music

    hussein62336
    F
    license
    Not graded
    quality
    A
    maintenance
    Gives MCP clients control of Apple Music playlists, library, catalog, discovery, playback, and the Up Next queue across macOS, Windows, and Linux, using Music.app, Safari, the Apple Music API, or Chrome.
    -

  • applemusic-mcp

    Butler38235
    F
    license
    Not graded
    quality
    A
    maintenance
    Enables MCP clients to search the catalog, manage playlists, folders, and library items, and control playback, ratings, and the Up Next queue across macOS, Windows, and Linux. It selects among native Music.app, Safari, Chrome, and web API engines so an assistant can drive Apple Music with or without a subscription.
    -