MCP-AppleMusic logo

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.

View on GitHub

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?

  1. Install Python 3.13+ and the MCP library.
  2. Configure Claude Desktop with the provided JSON snippet.
  3. Start the server using python server.py.
  4. 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?

Only macOS is supported due to the AppleScript dependency.

What is the minimum Python version required?

Python 3.13 or higher is required.

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?

Use brew install uv and pip install -e ".[dev]" for development dependencies.

Where can I find the available commands?

The available commands are listed in the README under the 'Available Commands' section.