apple_music_mcp
Provides comprehensive control over Apple Music, including playlist management, catalog search, playback control, and personalized recommendations.
Synchronizes Apple Music playlist descriptions and metadata to iCloud.
Enables discovery of top hits from Shazam charts and direct population into Apple Music playlists.
Enables discovery of top hits from Spotify charts and direct population into Apple Music playlists.
Enables discovery of top hits from YouTube charts and direct population into Apple Music playlists.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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-mcpOption B: Using uvx
uvx --from git+https://github.com/saitarrun/apple-music-mcp.git apple-music-mcp serveOption 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.gitRelated MCP server: mcp-applemusic
🔌 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-mcp2. 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 |
| Pull top hits from Shazam, Spotify, YouTube, or Apple Music charts. |
| Populate a playlist directly from any chart with deduplication. | |
| Smart recommendations based on listening history & artists. | |
| Fetch recent listening history from Apple Music cloud. | |
| Fetch most played albums and playlists. | |
Playlists |
| List all library playlists with track counts and descriptions. |
| Fast bulk retrieval of tracks (title, artist, album, duration). | |
| Parallel batch add with zero duplicates. | |
| Bulk remove track relationship IDs. | |
| Create new playlist with custom description. | |
| Safely delete playlist without removing songs from library. | |
| Update playlist description and sync to iCloud. | |
Catalog |
| Search global Apple Music catalog (songs, albums, artists, playlists). |
| Pin exact studio audio catalog ID for title/artist. | |
| Get top-rated songs for any artist. | |
| Fetch tracks from official Apple curated playlists ( | |
Playback |
| Control player ( |
| Discover available AirPlay speakers and HomePods. | |
Curation |
| Strip video entities and swap with official studio audio songs. |
| Deduplicate playlist editions, keeping canonical tracks. | |
| 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.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP connector for iMessage & Contacts via a local Mac agent + Vercel relay
Spotify MCP server for ChatGPT, Claude and any AI agent: search songs and artists, list playlists, read playlist songs, create playlist, add songs to playlist, remove songs from playlist, set playlist public or private and save to Liked Songs in your own Spotify account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Spotify yourself; Cotlet does not store your password and you need no Spotify API key. About the official Spotify API: Spotify has a full Web API and, since 23 Apr 2026, an official connector for Claude (checked 5 Nov 2026). The API needs an app you register, and in development mode the app owner must have Premium and the app allows 5 users; unlimited users need a registered business with at least 250,000 monthly users. Setup and FAQ: https://cotlet.dev/integrations/spotify-api-mcp-server
MCP connector that lets ChatGPT list, search, and run your Apple Shortcuts via a local Mac agent
Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server for controlling Apple Music on macOS using JXA (JavaScript for Automation). Manage playback, search tracks, create playlists, and more without API keys.14 npmMIT
- AlicenseBqualityBmaintenanceThe ultimate 66-tool Apple Music MCP server for macOS: playback, Spotify playlist importer, listening journal, Replay reports, smart DJ crossfades, and AirPlay.663MIT
- FlicenseNot gradedqualityAmaintenanceGives MCP clients control of Apple Music playlists, library, catalog, discovery, playback, and the Up Next queue, using four interchangeable engines that run on macOS, Windows, and Linux. Requires only a Mac or an Apple Music subscription, with the API engine needing no browser or Music app at all.-
- FlicenseNot gradedqualityAmaintenanceEnables any MCP client to control Apple Music playlists, library, catalog, discovery, playback, and the Up Next queue on macOS, Windows, and Linux using selectable native, API, Safari, or Chrome engines. Provides catalog and library search, playlist and folder management, ratings and favorites, playback controls, queue management, AirPlay selection, and cross-platform support with or without an Apple Music subscription.-