MCP Apple Music

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/cifero74-mcp-apple-music

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools

10 read · 4 write · 1 delete

Secrets

2 (API keys, tokens or passwords)

Install scripts

None found

Runs as

Python package

Tools (15)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• add_to_library

  Save Apple Music catalog songs, albums or playlists into the user's library. Use this when the user wants to keep something found with search_catalog, get_playlist_tracks or get_recommendations. Saved playlists then appear in get_library_playlists. Args: song_ids: Comma-separated catalog song IDs (numeric). album_ids: Comma-separated catalog album IDs (numeric). playlist_ids: Comma-separated catalog playlist IDs (start with 'pl.').

• add_tracks_to_playlist

  Add tracks to an existing playlist. Args: playlist_id: The target playlist ID (starts with 'p.'). track_ids: List of track IDs to add. track_type: 'library-songs' for tracks from your library (default), 'songs' for catalog tracks (from search_catalog or a catalog 'pl.' playlist).

• create_playlist

  Create a new playlist in your Apple Music library. Args: name: Name for the new playlist. description: Optional short description.

• favorite_song

  Mark a catalog song as favorite (the star in Apple Music). Args: song_id: Catalog song ID (use search_catalog to find it).

• get_library_albums

  List albums saved in your Apple Music library. Args: limit: Number of albums to return, 1–100 (default 25). offset: Pagination offset (default 0).

• get_library_artists

  List artists in your Apple Music library. Args: limit: Number of artists to return, 1–100 (default 25). offset: Pagination offset (default 0).

• get_library_playlists

  List all playlists in your Apple Music library. Args: limit: Maximum number of playlists to return, 1–100 (default 100).

• get_library_songs

  List songs saved in your Apple Music library. Args: limit: Number of songs to return, 1–100 (default 25). offset: Pagination offset for retrieving subsequent pages (default 0).

• get_playlist_tracks

  Get the tracks inside a playlist: one of the user's own playlists, or an Apple Music catalog playlist (editorial, themed, curator playlists). Apple Music returns at most 100 tracks per request. Use ``offset`` to page through a large playlist, or set ``fetch_all=True`` to automatically fetch every page (up to ``max_tracks``). Args: playlist_id: Library playlist ID (starts with 'p.', from get_library_playlists) or catalog playlist ID (starts with 'pl.', from search_catalog or get_recommendations). limit: Maximum tracks to return for a single page, 1–10…

• get_recently_played

  Get your recently played albums, playlists, and stations. Note: Apple Music API returns recently-played containers (albums, playlists, stations) rather than individual tracks. Args: limit: Number of items to return, 1–10 (default 10). The /me/recent/played endpoint rejects anything above 10.

• get_recommendations

  Get personalised Apple Music recommendations. Args: limit: Number of recommendation groups to return, 1–10 (default 5).

• get_song_favorite_status

  Check which catalog songs are marked as favorite. Args: song_ids: Comma-separated catalog song IDs (e.g. "1276760751,123").

• search_catalog

  Search all of Apple Music (not just the user's library) for songs, albums, artists and playlists. Use this whenever the user asks for music that may not be in their library. For moods, genres, activities or eras (e.g. "relax", "workout", "jazz anni 60") search with types="playlists" to find Apple's themed playlists, then open one with get_playlist_tracks. Args: query: Search term (e.g. "Radiohead", "Bohemian Rhapsody", "relax"). types: Comma-separated resource types to include. Options: songs, albums, artists, playlists (default: all four). limit: Results per type, 1–2…

• search_library

  Search only what the user has saved in their Apple Music library. To search all of Apple Music, use search_catalog instead. Args: query: Search term. types: Comma-separated types. Options: library-songs, library-albums, library-artists, library-playlists limit: Results per type, 1–25 (default 10).

• unfavorite_song

  Remove a catalog song from favorites (clears its rating). Args: song_id: Catalog song ID.

Signals

Stars

44

Forks

11

Open issues

1

Weekly downloads

160

Last commit

Oct 22, 2026 (10 days ago)

Last release

Oct 22, 2026 (10 days ago)

Last package publish

Oct 22, 2026 (10 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.Cifero74/mcp-apple-music

Version

1.3.0

Auth

API key

Packages

pypi mcp-apple-music-server

License

MIT

Repository

github.com/Cifero74/mcp-apple-music

First seen

Oct 24, 2026

Last checked

Oct 25, 2026

Source

Official MCP Registrygithub-graphql