musicbrainz-mcp
An MCP server that gives Claude read access to MusicBrainz metadata (and Cover Art Archive images), plus optional OAuth-backed writes to your own account.
Search any entity type with plain or fielded Lucene queries; returns ranked matches with MBIDs.
Look up a single entity by MBID, with
incsubqueries for linked data and relationships.Browse the complete, paged set of entities linked to another (e.g. every release by an artist, recordings on a release).
Get cover art — front/back cover URLs, thumbnails, and image types for a release or release-group.
Resolve a pasted musicbrainz.org URL into its underlying entity.
Healthcheck API reachability and whether OAuth writes are configured.
Write (optional OAuth): submit tags, set a 0–100 rating, and add/remove entities in your collections — each confirmed before anything is sent.
Reads accept a
view(compactdefault strips image/avatar URLs;fullreturns MusicBrainz's payload untouched); responses are self-throttled to one request per second.
Allows interaction with the MusicBrainz open music encyclopedia, providing tools for searching, looking up, and browsing artists, releases, recordings, labels, works, and more, including Cover Art Archive images and optional submission of user tags, ratings, and collection edits.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@musicbrainz-mcp search for artist "Radiohead""
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
musicbrainz-mcp
An MCP server for MusicBrainz, the open music encyclopedia. It gives Claude live access to MusicBrainz metadata — artists, releases, recordings, labels, works, and more — plus Cover Art Archive images, and (optionally) lets you submit your own tags, ratings, and collection edits.
Developed and maintained by AI (Claude Code). Use at your own discretion.
Tools
Read (no credentials required):
Tool | What it does |
| Search any entity type with a Lucene query; returns ranked matches + MBIDs |
| Look up an entity by MBID, with |
| List all entities linked to another (e.g. every release by an artist) |
| Cover Art Archive image URLs for a release / release-group |
| Turn a pasted musicbrainz.org URL into its entity |
| Verify connectivity and whether OAuth writes are configured |
Write (OAuth, confirmed before sending):
Tool | What it does |
| Apply user tags to an entity on your account |
| Set your 0–100 rating for an entity |
| Add/remove entities in one of your collections |
Each write asks you to confirm before it makes any network call — see Confirmations.
Every read above takes a view, except musicbrainz_cover_art. It defaults to
compact, which strips image and avatar URLs — a subtractive rule, so it cannot
drop a field nobody knew was there; view: "full" returns MusicBrainz's payload
untouched. musicbrainz_cover_art takes none on purpose: the image URLs are
its answer, and stripping them would not shrink the response, it would empty it.
Related MCP server: musicbrainz-mcp-server
Install
This is a Node MCP server (stdio). Point your MCP host at it:
{
"mcpServers": {
"musicbrainz": {
"command": "npx",
"args": ["-y", "musicbrainz-mcp"]
}
}
}Reads work immediately. MusicBrainz asks clients to make at most one request per second — the server throttles itself to stay within that limit, so large browses are paced automatically.
Enabling the write tools (optional)
Register an application at musicbrainz.org/account/applications (redirect URI
urn:ietf:wg:oauth:2.0:oob).Complete the OAuth flow with the
tag,rating, andcollectionscopes to obtain a refresh token.Provide these via your MCP host's env (or a local
.env):
MUSICBRAINZ_OAUTH_CLIENT_ID=...
MUSICBRAINZ_OAUTH_CLIENT_SECRET=...
MUSICBRAINZ_OAUTH_REFRESH_TOKEN=...Confirmations
Every write asks you first. A client that can show a confirmation prompt (Claude Code) shows one, with the entity, tags / rating / collection change. A client that cannot (claude.ai, Claude Desktop) gets a two-step flow instead: the first call sends nothing and returns a confirmation-required preview — the exact XML for tags and ratings, the method and path for collections — plus a confirmToken; only a repeat of the same call with that token submits. A token acts once, and changing any argument between the two calls invalidates it.
variable | default | |
|
| What a write does on a client that cannot show a confirmation prompt (claude.ai, Claude Desktop). |
|
|
|
|
| How long a token stays valid. |
| random per process | Signing key; set it only if tokens must survive a server restart. |
Development
npm install
npm run build
npm testSee CLAUDE.md for architecture and docs/MUSICBRAINZ-API.md for the pinned API shapes.
License
MIT. Data from MusicBrainz, licensed under CC0 / CC BY-NC-SA.
Available Tools
9 toolsmusicbrainz_browseBrowse MusicBrainz entities linked to anotherARead-onlyIdempotent
List all entities of one type directly linked to a given entity — e.g. every release by an artist (entity: "release", linkedBy: "artist", mbid: ), recordings on a release, releases in a collection (a private collection needs OAuth: MUSICBRAINZ_OAUTH_*), or events at a place. This is the complete, paged set for a relationship (unlike search, which ranks fuzzy matches). Use inc for extra detail and limit/offset to page (max 100/page). Read-only. Data from MusicBrainz (https://musicbrainz.org), the open music encyclopedia.
Inputs: mbid (required), entity (required), linkedBy (required), inc, +3 more.
musicbrainz_cover_artGet Cover Art Archive images for a releaseARead-onlyIdempotent
Fetch Cover Art Archive image metadata for a release or release-group MBID — front/back cover URLs, thumbnails, and image types. Returns the image URLs (you can open or download them); it does not embed the bytes. Errors clearly when no art exists for the MBID. Read-only. Data from MusicBrainz (https://musicbrainz.org), the open music encyclopedia.
Inputs: mbid (required), entity (required).
musicbrainz_healthcheckVerify MusicBrainz connectivityARead-onlyIdempotent
Confirm the MusicBrainz API is reachable (and our User-Agent accepted) by looking up a stable entity, and report whether the OAuth write path is configured. Reports {ok, reachable, oauth_configured} with a plain-English hint. Read-only.
Inputs: no named parameters.
musicbrainz_lookupLook up a MusicBrainz entity by MBIDARead-onlyIdempotent
Fetch a single MusicBrainz entity (artist, release, recording, release-group, label, work, area, place, event, instrument, series, genre, url) by its MBID. Use inc to pull linked sub-entities and relationships, e.g. inc: ["releases","release-groups"] on an artist, or ["recordings","labels"] on a release, or ["artist-credits","url-rels"] on most entities. Your own tags/ratings (inc: ["user-tags"], ["user-ratings"], …) need OAuth (MUSICBRAINZ_OAUTH_*). Read-only. Data from MusicBrainz (https://musicbrainz.org), the open music encyclopedia.
Inputs: mbid (required), entity (required), inc, view.
musicbrainz_modify_collectionAdd or remove entities in a MusicBrainz collectionADestructiveIdempotent
Add or remove entities (releases, artists, recordings, release-groups, works, labels, places, areas, events) in one of YOUR MusicBrainz collections (needs OAuth: MUSICBRAINZ_OAUTH_* with the collection scope). Get the collection MBID from its URL (musicbrainz.org/collection/). Asks the user to confirm first: a confirmation prompt where the client supports one; otherwise the first call returns a preview and a confirmToken, and only a repeat call with that token proceeds (see MCP_CONFIRM_MODE). Nothing is changed before confirmation. Data from MusicBrainz (https://musicbrainz.org), the open music encyclopedia.
Inputs: mbids (required), action (required), collection (required), entityType (required), +1 more.
musicbrainz_resolveResolve a MusicBrainz URL to its entityARead-onlyIdempotent
Turn a musicbrainz.org URL (e.g. https://musicbrainz.org/artist/ or /release-group/) into the underlying entity by extracting its type + MBID and looking it up. Handy when a user pastes a MusicBrainz link. Pass inc to include linked sub-entities. Read-only. Data from MusicBrainz (https://musicbrainz.org), the open music encyclopedia.
Inputs: url (required), inc, view.
musicbrainz_searchSearch MusicBrainzARead-onlyIdempotent
Search a MusicBrainz entity type with a Lucene query and get back ranked matches with their MBIDs. Plain text matches the entity name; fielded Lucene also works, e.g. artist:"Miles Davis" AND country:US, release:"Kind of Blue" AND format:Vinyl, or recording:"So What" AND dur:[540000 TO 560000]. Feed a returned MBID into musicbrainz_lookup for full detail. Read-only. Data from MusicBrainz (https://musicbrainz.org), the open music encyclopedia.
Inputs: query (required), entity (required), view, limit, +1 more.
musicbrainz_submit_ratingSubmit a user rating to MusicBrainzADestructiveIdempotent
Set YOUR rating for a MusicBrainz entity (needs OAuth: MUSICBRAINZ_OAUTH_* with the rating scope). Rating is 0–100 (MusicBrainz shows it as 1–5 stars in steps of 20; 0 removes your rating). Asks the user to confirm first: a confirmation prompt where the client supports one; otherwise the first call returns a preview and a confirmToken, and only a repeat call with that token proceeds (see MCP_CONFIRM_MODE). Nothing is sent before confirmation. Data from MusicBrainz (https://musicbrainz.org), the open music encyclopedia.
Inputs: mbid (required), entity (required), rating (required), confirmToken.
musicbrainz_submit_tagsSubmit user tags to MusicBrainzADestructiveIdempotent
Apply user tags to a MusicBrainz entity on YOUR account (needs OAuth: MUSICBRAINZ_OAUTH_* with the tag scope). Default vote: upvote adds the tags; downvote opposes them; withdraw removes your vote. Asks the user to confirm first: a confirmation prompt where the client supports one; otherwise the first call returns a preview and a confirmToken, and only a repeat call with that token proceeds (see MCP_CONFIRM_MODE). The preview shows the exact XML; nothing is sent before confirmation. Data from MusicBrainz (https://musicbrainz.org), the open music encyclopedia.
Inputs: mbid (required), tags (required), entity (required), vote, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool has a distinct purpose: lookup (single entity by MBID), browse (paged linked entities), search (Lucene ranking), resolve (URL parsing), cover_art, three OAuth writes, and healthcheck. There is mild overlap between lookup and resolve (resolve is essentially URL-extraction + lookup) and between browse and search, but descriptions clearly differentiate ranked-fuzzy vs complete-paged semantics.
All tools use a consistent musicbrainz_ prefix and snake_case, which is highly predictable. The verb portion mixes styles slightly (submit_tags, submit_rating, modify_collection vs noun-ish lookup, browse, search, resolve, healthcheck), but this is readable and largely intuitive.
Nine tools is well-scoped for a MusicBrainz client covering reads, search, resolution, cover art, and the three OAuth write paths. No tool feels redundant or gratuitous, and nothing is obviously missing from the count.
The surface covers the core read lifecycle (search, lookup, browse, resolve, cover art) plus the realistic write operations MusicBrainz allows via OAuth (tags, ratings, collections) and a healthcheck. Minor gaps remain (e.g. no explicit release-group or genre-centric browse helper), but agents can work around them with lookup/browse and inc.
Maintenance
Related MCP Connectors
Unofficial MusicBrainz MCP — wraps MusicBrainz Web Service v2 (free, no auth)
Search MusicBrainz artists, releases, works, labels; resolve ISRC/ISWC/barcode; fetch cover art.
TheAudioDB MCP — community music metadata database.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA comprehensive MCP server for querying the MusicBrainz database, providing tools to search for artists, releases, recordings, and browse music metadata.4MIT
- AlicenseNot gradedqualityBmaintenanceSearch artists, releases, recordings, works, and labels; traverse relationships; resolve ISRC/ISWC/barcode; fetch cover art via MCP. STDIO or Streamable HTTP.157 npm2Apache 2.0
- AlicenseNot gradedqualityBmaintenanceAn MCP server that enables searching books and authors, fetching editions, browsing subjects, and resolving cover images from Open Library.267 npm4Apache 2.0
- AlicenseNot gradedqualityBmaintenanceAn MCP server for the Last.fm API, exposing artist, album, track, chart, and user data as read-only tools. Supports optional writes, auth, and experimental methods over stdio or HTTP.MIT