SkillFoxx

applemusic-mcp: Apple Music for Claude and Cursor

applemusic-mcp

An MCP server for Apple Music playlists, library, catalog, playback and the queue, with an access level that you set

  • 134 ★ on the repository
  • Last commit
  • MIT
MCP server

Extended access

Why this level

  • Changes playlists and library, controls playback and at level full clicks inside the app
  • Sign-in uses your session in Safari or Chrome
All reasons and checks

epheterson/applemusic-mcpAuthor:epheterson

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/applemusic-mcp

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Changes playlists and library, controls playback and at level full clicks inside the app
  • Sign-in uses your session in Safari or Chrome

This is third-party code. Review the repository files before installing.

What it does

The server gives an assistant control of Apple Music on macOS, Windows and Linux. Seven tools pick the action by an `action` parameter to keep context small: `playlist` creates, renames and fills playlists, `library` searches and rates, `catalog` searches the catalog, `discover` returns recommendations and charts, `playback` starts songs and changes volume, `queue` manages the Up Next queue, and `config` handles sign-in and settings. The access level is set with the `--level` key in the client config, and the assistant cannot change it. Level `music` touches only the Music app on a Mac and works offline, `api` adds Apple's service over the internet, `web` adds a web player in Safari or Chrome, `full` turns everything on, and `--allow-ui` permits clicking inside the app. Tools that need more rights are simply not shown to the assistant. Sign-in is done by `applemusic-mcp login`: on a Mac it reads your Safari session, and your password never reaches the tool.

Who it is for. Apple Music listeners who build playlists and control playback by voice or text through Claude, Cursor or another MCP client.

Good fit when

  • You want a road trip playlist of upbeat 90s alternative rock built on request
  • You want to shuffle your workout playlist and queue a catalog song next
  • You wonder what you have been listening to lately and what is in the charts now
  • The library grew and you need to sort playlists into folders, rename them and drop duplicates

Not a fit when

  • You do not use Apple Music: the server works only with that service
  • You need the Up Next queue in the Music app on a Mac: the queue works through a web player in Safari or Chrome
  • You are not ready to give an assistant access to your library and playback: even level music gives control of the app

Example request

Create a playlist called Road Trip of upbeat 90s alternative, add twenty songs and play it on shuffle.

MCP

Transport
stdio
Authentication
OAuth

Limitations

Python 3.10 or newer and either a Mac or an Apple Music subscription are needed. Level `music` works only on macOS, and on Windows and Linux you start with `api`. The web player and the queue need a desktop session with Safari on a Mac or Google Chrome elsewhere. Catalog search and catalog playback in Music.app click inside the app and need `--allow-ui`, and for Safari sign-in you switch on "Allow JavaScript from Apple Events" once.

Some functions exist for one engine only: star ratings and AirPlay work only in Music.app on a Mac, recommendations and charts only through the API. For bulk imports the author advises your own Apple developer token. The last commit is from November 2026.

How to disable. Remove the server from the client config and run `applemusic-mcp logout`, and for a full wipe run `applemusic-mcp reset --all --force`, which deletes the `.p8` key, profile and cache.

FAQ

How do I install applemusic-mcp in Claude Code?

With one command: `claude mcp add "Apple Music" -- uvx applemusic-mcp serve --level music`. For Claude Desktop, Cursor, Cline and Windsurf run `pipx install applemusic-mcp` and add a block with `applemusic-mcp serve --level music`.

Which access level should I pick?

Start with `music`: it touches only the Music app on a Mac with no network. Move to `api`, `web` or `full` when you need the catalog, the queue or clicks in the app.

How do I sign in to Apple Music?

Run `applemusic-mcp login`. On a Mac the tool reads your Safari session, and on Windows and Linux it opens Chrome. Your password does not reach the tool.

Does the server work on Windows and Linux?

Yes, through levels `api` and `web`, which need an Apple Music subscription. Level `music` requires a Mac.

Can the assistant widen its own rights?

No, the access level is set in the client config and the assistant cannot change it. Tools that lack rights are not shown to it.

Discussion

No questions or reviews yet.

MCP servers
Russian stack

A browser-free Yandex Music MCP server: the agent queues a playlist, a local daemon plays it via mpv with Now Playing in Control Center

MCP serverExtended access1

A Spotify MCP server for Claude Desktop: music search, playback and playlist control and listening history.

MCP serverExtended access53

A Spotify MCP server: the agent searches music, controls playback, queue and volume, and builds and edits playlists and the library

MCP serverBroad access506
Russian stack

An unofficial Yandex Music MCP server: likes, genre analysis, search and playlist management over HTTP or stdio

MCP serverExtended access2
Russian stack

An MCP server for a local Rust-based Yandex Music player and sync daemon on Linux: playback control, taste profile, mood picks

MCP serverBroad access

README in short

The README shows access levels and a capability table by engine (Music app, Apple API, web player), install and client wiring, sign-in, seven tools with actions and the CLI commands. A community fork with guided Mac setup is mentioned separately.

README badge

Report a problem