What is Mcp Applemusic

mcp-applemusic is an experimental MCP server designed to control Apple Music on macOS using AppleScript commands.

Use cases

Use cases include automating music playback, creating custom playlists, and managing your Apple Music library through scripts or applications that can send commands to the MCP server.

How to use

To use mcp-applemusic, install the required dependencies, configure the server in Claude Desktop, and start the server using the command ‘python server.py’. You can then interact with the server using various commands to control playback and manage your music library.

Key features

Key features include playback control (play, pause, next, previous), searching for tracks, playing specific songs, and creating playlists. It also provides library statistics.

Where to use

undefined

MCP-AppleMusic

A FastMCP server implementation for controlling Apple Music (formerly iTunes) on macOS through AppleScript commands.

Requirements

• Python 3.13+
• macOS with Apple Music app installed
• MCP library ≥1.2.1

Installation

First, ensure you have uv installed:

$ brew install uv

Then, with Claude Desktop, add the following to claude_desktop_config.json:

{
  "mcpServers": {
    "iTunesControlServer": {
      "command": "uvx",
      "args": [
        "-n",
        "mcp-applemusic"
      ]
    }
  }
}

Available Commands

The following commands are available through the MCP server:

itunes_play()         # Start playback
itunes_pause()        # Pause playback
itunes_next()         # Skip to next track
itunes_previous()     # Go to previous track
itunes_search(query)  # Search library for tracks
itunes_play_song(song)  # Play specific song
itunes_create_playlist(name, songs)  # Create new playlist
itunes_library()      # Get library statistics

Usage

Start the server:

python server.py

Example interactions:

# Search for a song
results = itunes_search("Hey Jude")

# Create a new playlist
itunes_create_playlist("Beatles Favorites", ["Yesterday", "Hey Jude", "Let It Be"])

# Play a specific song
itunes_play_song("Hey Jude")

Development

1. Clone the repository:

git clone https://github.com/yourusername/mcp-applemusic.git
cd mcp-applemusic

2. Install development dependencies:

pip install -e ".[dev]"

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Notes

• This tool only works on macOS systems due to its AppleScript dependency
• Requires Apple Music (formerly iTunes) to be installed