MCP-AppleMusic
by kennethreitz
MCP-AppleMusic is a FastMCP server implementation for controlling Apple Music on macOS using AppleScript. It allows you to manage your Apple Music library and playback remotely.
Last updated: N/A
What is MCP-AppleMusic?
MCP-AppleMusic is a server that allows you to control Apple Music (formerly iTunes) on macOS through AppleScript commands. It acts as an MCP (Message Control Protocol) server, enabling remote control of your music library and playback.
How to use MCP-AppleMusic?
- Install Python 3.13+ and the MCP library.
- Configure Claude Desktop with the provided JSON snippet.
- Start the server using
python server.py
. - Use the available commands (e.g.,
itunes_play()
,itunes_search()
) to interact with Apple Music.
Key features of MCP-AppleMusic
Playback control (play, pause, next, previous)
Library search
Playlist creation
Song playback
Library statistics
Use cases of MCP-AppleMusic
Remote control of Apple Music on macOS
Integration with home automation systems
Building custom music control interfaces
Automating music library management
Controlling music playback from other applications
FAQ from MCP-AppleMusic
What operating systems are supported?
What operating systems are supported?
Only macOS is supported due to the AppleScript dependency.
What is the minimum Python version required?
What is the minimum Python version required?
Python 3.13 or higher is required.
Do I need to have Apple Music installed?
Do I need to have Apple Music installed?
Yes, Apple Music (formerly iTunes) must be installed on your macOS system.
How do I install the required dependencies?
How do I install the required dependencies?
Use brew install uv
and pip install -e ".[dev]"
for development dependencies.
Where can I find the available commands?
Where can I find the available commands?
The available commands are listed in the README under the 'Available Commands' section.