Skip to main content
Glama
mk-8

Amazon Music MCP Server

by mk-8

Amazon Music MCP 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

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

-
security - not tested
A
license - permissive license
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mk-8/amazon-music-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server