Amazon Music Server

Control Amazon Music playback through Claude Desktop using the Model Context Protocol.

Features

• ▶️ Play/Pause current track
• ⏭️ Skip to next track
• 🔍 Search and play songs, artists, or albums
• 🎵 Works with any Amazon Music subscription

Prerequisites

• Python 3.10 or higher
• Google Chrome browser
• Amazon Music account
• Claude Desktop app

Installation

1. Install via pip (coming soon)

pip install amazon-music-mcp

2. Manual Installation

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

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

# Install dependencies
pip install -e .

Setup

1. Configure Claude Desktop

Add this to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Or if using manual installation:

{
  "mcpServers": {
    "amazon-music": {
      "command": "/path/to/your/.venv/bin/python",
      "args": ["/path/to/amazon-music-mcp/server.py"]
    }
  }
}

2. Start Chrome with Remote Debugging

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

3. Restart Claude Desktop

Completely quit and restart Claude Desktop for changes to take effect.

Usage

Once configured, you can ask Claude to control your music:

• "Play the current track"
• "Pause the music"
• "Skip to the next track"
• "Search for and play Bohemian Rhapsody"
• "Play songs by Taylor Swift"

Available Commands

Command	Description
play	Resume playback
pause	Pause current track
next_track	Skip to next song
search_and_play	Search and play by artist, song, or album

Troubleshooting

Chrome Connection Issues

Make sure Chrome is running with remote debugging:

# Check if port 9222 is in use
lsof -i :9222  # macOS/Linux
netstat -ano | findstr :9222  # Windows

Server Not Appearing in Claude

1. Verify the config file path is correct
2. Check that Python path points to correct interpreter
3. Restart Claude Desktop completely
4. Check Claude Desktop logs for errors

Playwright/Browser Errors

• Ensure you're logged into Amazon Music
• Keep the Chrome window open
• Don't close the Amazon Music tab

Development

Running Tests

python3 test_server.py

Project Structure

amazon-music-mcp/
├── amazon_music_mcp/
│   ├── __init__.py
│   ├── __main__.py
│   ├── server.py
│   └── music.py
├── pyproject.toml
├── requirements.txt
├── README.md
├── LICENSE
├── .gitignore

How It Works

1. MCP server connects to Chrome via Chrome DevTools Protocol (CDP)
2. Playwright automates the Amazon Music web interface
3. Claude Desktop communicates with the server via MCP protocol
4. Commands are translated to browser automation actions

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see LICENSE file for details

Support

• Report issues: GitHub Issues
• Documentation: Full Docs

Roadmap

• PyPI package publication
• Volume control
• Playlist management
• Current song information
• Queue management
• Support for Spotify, YouTube Music
• Windows/Linux testing

Author

Meet Kavathiya - @meetkavathiya

Acknowledgments

• Built with Model Context Protocol
• Browser automation by Playwright