Music MCP 🎵

Model Context Protocol server that gives AI agents a searchable catalog of the most extensive list of free, open-source, royalty-free music sources. Search once, get licensed tracks with ready-to-paste attribution from multiple catalogs — no embedded audio, no API keys required for the default sources.

Sources

Every result carries license, license_url, audio_url and a ready-to-paste attribution string — the credit you must include, verbatim.

Quickstart

# 1-line installer: installs uv + music-mcp, then wires it into the
# agents you already have (Claude Code, Claude Desktop, Cursor, Gemini CLI)
curl -fsSL "https://music-mcp-install-telemetry.reachsuren.workers.dev/?src=readme" | bash

# or any of:
uvx free-music-library-mcp
npx free-music-library-mcp
pip install free-music-library-mcp

Claude Code

claude mcp add --transport stdio music-mcp -- uvx --from free-music-library-mcp music-mcp-server

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "music-mcp": {
      "command": "uvx",
      "args": ["--from", "music-mcp", "music-mcp-server"]
    }
  }
}

Cursor

MCP settings → Add: uvx --from free-music-library-mcp music-mcp-server (or use the 1-click install page).

Gemini CLI

gemini config add music-mcp "uvx --from free-music-library-mcp music-mcp-server"

Usage

Example agent conversation: "Find a royalty-free ambient track for a podcast intro and give me the attribution."

Optional: enable Jamendo & Freesound

These two sources cover hundreds of thousands of additional CC tracks. Both keys are free:

export MUSIC_MCP_JAMENDO_CLIENT_ID="your-free-client-id"   # developer.jamendo.com
export MUSIC_MCP_FREESOUND_TOKEN="your-free-token"          # freesound.org/apiv2/apply

Sources without keys are skipped automatically and reported in skipped in the search result.

Telemetry & Privacy

Music MCP collects anonymous usage telemetry (like GA4 MCP and other sibling servers): a random installation UUID, agent name, OS, and event counts (mcp_started, tool_executed, ...). It goes through a Cloudflare Worker gateway that strips IPs and honors Do-Not-Track. No PII, no search queries, no local paths, no audio content — ever.

Opt out any time:

export MUSIC_MCP_TELEMETRY=false
# or
export DO_NOT_TRACK=1

Development

python -m venv .venv && source .venv/bin/activate
pip install -e . pytest
pytest
python -m music_mcp

Baked catalogs are generated from verified public listings:

python scripts/build_catalogs.py   # refreshes music_mcp/catalogs/*.json

License

Apache-2.0. The music itself is licensed by each source — always include the attribution string the server returns.