Skip to main content
Glama
Sign In
apple-music-mcp

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    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

    ActivityStale
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • am-mcp

      Z-Han-Z
      A
      license
      A
      quality
      B
      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
      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.
      -

    • applemusic-mcp

      terrye5097
      F
      license
      Not graded
      quality
      A
      maintenance
      Enables MCP clients to manage Apple Music playlists, library, catalog, discovery, playback, and the Up Next queue across macOS, Windows, and Linux using native Music.app, the Apple Music API, Safari, or Chrome engines.
      -