apple_music_mcp
Apple Music MCP
Un servidor Model Context Protocol (MCP) de alto rendimiento para Apple Music. Motor dual nativo de macOS JXA y REST en la nube con descubrimiento multiplataforma, procesamiento por lotes asíncrono y ejecución sin tiempo de espera.
⚡ Inicio rápido
Ejecuta al instante con npx o uvx (sin instalación necesaria):
Opción A: Usar npx (Recomendado)
npx -y @saitarrunpitta/apple-music-mcpOpción B: Usar uvx
uvx --from git+https://github.com/saitarrun/apple-music-mcp.git apple-music-mcp serveOpción C: Instalar localmente mediante npm o pip
npm install -g @saitarrunpitta/apple-music-mcp
# or
pip install git+https://github.com/saitarrun/apple-music-mcp.gitRelated MCP server: mcp-applemusic
🔌 Configuración del cliente MCP
Añade apple-music a tu asistente de IA preferido en segundos:
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✨ Características de un vistazo
⚡ Motor JXA sin tiempo de espera: Lee listas de reproducción con más de 1000 canciones en menos de 100 ms sin bloqueos de AppleScript.
🌐 Listas de éxitos multiplataforma: Fuentes de descubrimiento directas de Shazam, Spotify, YouTube y Apple Music.
🚀 Procesamiento por lotes asíncrono en paralelo: Añade o elimina más de 100 canciones en paralelo en menos de 1 segundo.
🎵 Garantía de audio puro: Filtra automáticamente los vídeos musicales y los vídeos con letra para mantener las listas de reproducción en audio puro.
🛡️ Prevención de duplicados al 100%: El emparejamiento difuso integrado evita añadir canciones duplicadas.
🔐 Autenticación automática con Safari: Extrae sin problemas los tokens del reproductor web de Safari sin necesidad de claves de API manuales.
🧠 Recomendaciones inteligentes: Sugerencias de canciones en tiempo real basadas en tu historial de escucha y en la similitud entre artistas.
🛠️ Referencia de herramientas
Categoría | Herramienta | Descripción |
Descubrimiento |
| Obtén los mayores éxitos de las listas de Shazam, Spotify, YouTube o Apple Music. |
| Rellena una lista de reproducción directamente desde cualquier lista con deduplicación. | |
| Recomendaciones inteligentes basadas en el historial de escucha y en los artistas. | |
| Obtén el historial de escucha reciente de la nube de Apple Music. | |
| Obtén los álbumes y las listas de reproducción más reproducidos. | |
Listas de reproducción |
| Enumera todas las listas de reproducción de la biblioteca con el número de canciones y descripciones. |
| Recuperación masiva y rápida de canciones (título, artista, álbum, duración). | |
| Adición por lotes en paralelo sin duplicados. | |
| Eliminación masiva de IDs de relación de canciones. | |
| Crea una nueva lista de reproducción con descripción personalizada. | |
| Elimina la lista de reproducción de forma segura sin quitar canciones de la biblioteca. | |
| Actualiza la descripción de la lista de reproducción y sincronízala con iCloud. | |
Catálogo |
| Busca en el catálogo global de Apple Music (canciones, álbumes, artistas, listas de reproducción). |
| Fija el ID de catálogo de audio de estudio exacto para el título/artista. | |
| Obtén las canciones mejor valoradas de cualquier artista. | |
| Obtén canciones de listas de reproducción oficiales seleccionadas por Apple ( | |
Reproducción |
| Controla el reproductor ( |
| Descubre los altavoces AirPlay y HomePods disponibles. | |
Curación |
| Elimina las entidades de vídeo y sustitúyelas por canciones oficiales de audio de estudio. |
| Deduplica las ediciones de las listas de reproducción, conservando las canciones canónicas. | |
| Combina listas de reproducción con deduplicación al 100%. |
💻 Comandos CLI
# 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🏷️ Etiquetas y visibilidad
#ModelContextProtocol #MCP #MCPServer #AppleMusic #ClaudeAI #CursorAI #AnthropicClaude #AIAgents #MusicKit #Spotify #Shazam #YouTubeMusic #AppleScript #Python #OpenSource #DeveloperTools #LLM #Automation #PlaylistGenerator
📄 Licencia
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.-