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

Clone the repository:


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

Install development dependencies:


pip install -e ".[dev]"

Contributing

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
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