Skip to main content
Glama
saitarrun

apple_music_mcp

Apple Music MCP

A high-performance Model Context Protocol (MCP) server for Apple Music. Dual native macOS JXA & cloud REST engine with cross-platform discovery, async batching, and zero-timeout execution.


⚡ Quick Start

Run instantly with npx or uvx (zero install required):

Option A: Using npx (Recommended)

npx -y @saitarrunpitta/apple-music-mcp

Option B: Using uvx

uvx --from git+https://github.com/saitarrun/apple-music-mcp.git apple-music-mcp serve

Option C: Install locally via npm or pip

npm install -g @saitarrunpitta/apple-music-mcp
# or
pip install git+https://github.com/saitarrun/apple-music-mcp.git

Related MCP server: apple-music-mcp

🔌 MCP Client Setup

Add apple-music to your preferred AI assistant in seconds:

1. Antigravity / AGY CLI

agy mcp add apple-music -- npx -y @saitarrunpitta/apple-music-mcp

2. Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "apple-music": {
      "command": "npx",
      "args": [
        "-y",
        "@saitarrunpitta/apple-music-mcp"
      ]
    }
  }
}

3. Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "apple-music": {
      "command": "npx",
      "args": [
        "-y",
        "@saitarrunpitta/apple-music-mcp"
      ]
    }
  }
}

4. Codex MCP

codex mcp add apple-music -- npx -y @saitarrunpitta/apple-music-mcp

✨ Features at a Glance

  • ⚡ Zero-Timeout JXA Engine: Reads playlists with 1,000+ songs in under 100ms without AppleScript freezes.

  • 🌐 Cross-Platform Charts: Direct discovery feeds from Shazam, Spotify, YouTube, and Apple Music.

  • 🚀 Async Parallel Batching: Add or remove 100+ songs in parallel in under 1 second.

  • 🎵 Pure-Audio Enforcement: Auto-filters out music videos and lyric videos to keep playlists pure audio.

  • 🛡️ 100% Duplicate Prevention: Built-in fuzzy matching prevents duplicate song additions.

  • 🔐 Automatic Safari Auth: Extracts web player tokens seamlessly from Safari without manual API keys.

  • 🧠 Smart Recommendations: Real-time track suggestions based on your listening history & artist similarity.


🛠️ Tools Reference

Category

Tool

Description

Discovery

apple_music_get_cross_platform_charts

Pull top hits from Shazam, Spotify, YouTube, or Apple Music charts.

apple_music_populate_from_charts

Populate a playlist directly from any chart with deduplication.

apple_music_get_music_recommendations

Smart recommendations based on listening history & artists.

apple_music_get_recently_played

Fetch recent listening history from Apple Music cloud.

apple_music_get_heavy_rotation

Fetch most played albums and playlists.

Playlists

apple_music_list_playlists

List all library playlists with track counts and descriptions.

apple_music_get_playlist_tracks

Fast bulk retrieval of tracks (title, artist, album, duration).

apple_music_add_tracks_to_playlist

Parallel batch add with zero duplicates.

apple_music_remove_tracks_from_playlist

Bulk remove track relationship IDs.

apple_music_create_playlist

Create new playlist with custom description.

apple_music_delete_playlist

Safely delete playlist without removing songs from library.

apple_music_set_playlist_description

Update playlist description and sync to iCloud.

Catalog

apple_music_search_catalog

Search global Apple Music catalog (songs, albums, artists, playlists).

apple_music_resolve_song

Pin exact studio audio catalog ID for title/artist.

apple_music_get_artist_top_songs

Get top-rated songs for any artist.

apple_music_get_catalog_playlist_tracks

Fetch tracks from official Apple curated playlists (pl.xxx).

Playback

apple_music_playback_control

Control player (play, pause, skip, volume, shuffle, rate, love).

apple_music_airplay_devices

Discover available AirPlay speakers and HomePods.

Curation

apple_music_curation_clean_videos

Strip video entities and swap with official studio audio songs.

apple_music_curation_deduplicate

Deduplicate playlist editions, keeping canonical tracks.

apple_music_curation_merge_playlists

Merge playlists with 100% deduplication.


💻 CLI Commands

# Check status & active tokens
apple-music-mcp status

# Extract authentication tokens from open Safari session
apple-music-mcp login

# Clear catalog cache
apple-music-mcp clean-cache

# Run MCP server over stdio
apple-music-mcp serve

🏷️ Tags & Discoverability

#ModelContextProtocol #MCP #MCPServer #AppleMusic #ClaudeAI #CursorAI #AnthropicClaude #AIAgents #MusicKit #Spotify #Shazam #YouTubeMusic #AppleScript #Python #OpenSource #DeveloperTools #LLM #Automation #PlaylistGenerator


📄 License

MIT © saitarrun

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/saitarrun/apple-music-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server