Amazon Music

You can control Amazon Music playback directly from Claude Desktop using the Model Context Protocol. This MCP server automates browser actions to play, pause, skip, and search music on Amazon Music, enabling hands-free control across your subscriptions and playlists.

How to use

After you configure the MCP server, you can ask Claude to manage playback with simple commands. You can play or pause the current track, skip to the next track, and search for and play songs, artists, or albums. Use natural language requests like "Play the current track", "Pause the music", "Skip to the next track", or "Search for and play Bohemian Rhapsody" to control playback.

How to install

Prerequisites you need before installation are Python 3.10 or higher, Google Chrome, an Amazon Music account, and the Claude Desktop app.

Step 1: Install via pip if available later.

Step 2: Manual installation. Run the following commands to set up the MCP server locally:

# Clone the repository
git clone https://github.com/mk-8/amazon-music-mcp.git
cd amazon-music-mcp

# Create a virtual environment
python3 -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
pip install -e .

Setup

Configure Claude Desktop to load the MCP server. Add or update the Claude Desktop config so Claude can start the server when you issue commands.

macOS config path:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows config path:

%APPDATA%\Claude\claude_desktop_config.json

Add a server entry to the MCP configuration so Claude can invoke the server via Python.

{
  "mcpServers": {
    "amazon-music": {
      "command": "python",
      "args": ["-m", "amazon_music_mcp"]
    }
  }
}

Starting the browser automation and Claude integration

Open Google Chrome with remote debugging enabled so the MCP server can connect to the browser automation layer.

# macOS/Linux
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
  --remote-debugging-port=9222 \
  https://music.amazon.com &

# Windows
"C:\Program Files\Google\Chrome\Application\chrome.exe" \
  --remote-debugging-port=9222 \
  https://music.amazon.com

Restart Claude Desktop

Quit Claude Desktop completely and then reopen it to apply the new MCP server configuration.

Troubleshooting

Chrome connection issues: ensure Chrome is running with remote debugging on port 9222. You can verify port usage with system commands for your OS.

If the server does not appear in Claude:

• verify the config file path is correct
• ensure the Python path points to the intended interpreter
• restart Claude Desktop completely
• check Claude Desktop logs for errors

Playwright or browser errors: make sure you are logged into Amazon Music, keep the Chrome window open, and do not close the Amazon Music tab.

Development

Running tests and exploring the project structure can help you contribute or customize the server.

Available tools

play

Resume playback of the current track.

pause

Pause the current track.

next_track

Skip to the next track.

search_and_play

Search for and play songs, artists, or albums.