musescore-mcp

MCP server for MuseScore — search sheet music and read score metadata. Routes through your signed-in musescore.com tab via the fetchproxy browser extension, so Cloudflare sees a real browser session instead of a Node process.

• Source: github.com/chrischall/musescore-mcp (private)

⚠️ MuseScore has no public consumer API (the old one was shut down). This server reads the same server-rendered data the musescore.com web app hydrates from, dispatched through your own signed-in browser tab via the fetchproxy extension. Use at your own discretion.

Setup

1. Install musescore-mcp

.mcp.json (project) or ~/.claude/mcp.json (global):

{
  "mcpServers": {
    "musescore": {
      "command": "node",
      "args": ["/absolute/path/to/musescore-mcp/dist/bundle.js"]
    }
  }
}

2. Install the fetchproxy extension and sign in

Install the fetchproxy browser extension and open musescore.com signed in, with the Cloudflare check cleared. Every request rides that tab's session.

Tools

• musescore_search — search scores. Defaults to MuseScore's "Free to view, play & download" facet (free_only=true); set free_only=false to search the whole catalog. Returns id, title, uploader, composer, instrumentation, difficulty, counts, and downloadability flags (free, downloadable, publicDomain, purchased, official).
• musescore_get_score — one score's metadata (title, license, measures, key, parts, duration, dates) by URL or user_id + score_id.
• musescore_download — resolve the official download URL (pdf/mid/mscz/mxl) for a free or entitled score, from the store's type_download_list. Returns the link to open in your browser (the MCP can't stream the file).
• musescore_score_to_pdf — resolve or create a PDF for a score. Returns the official PDF URL when MuseScore exposes one; otherwise fetches rendered SVG pages and stitches them into output_path via rsvg-convert.
• musescore_svg_to_pdf — convert local .svg / .svgz files already on disk into a PDF via rsvg-convert.
• musescore_healthcheck — verify the fetchproxy bridge end-to-end.

Downloads: free scores (is_free) are downloadable; paid scores need PRO/purchase. musescore_download resolves the official download URL from the store's type_download_list, gated on is_free or hasAccess, and returns the link for you to open in your browser — the MCP can't stream the file itself (Cloudflare + cross-origin S3 redirect). musescore_score_to_pdf writes a local PDF only in the SVG fallback path.

Notes

• Read-only. No credentials stored — auth lives in your browser tab.
• Optional env: MUSESCORE_WS_PORT (default 37149), MUSESCORE_DEBUG=1.