Skip to main content
Glama

musescore-mcp

A tool that wraps the MuseScore CLI as a Model Context Protocol (MCP) server, allowing Claude AI to directly convert, edit, and analyze music score files.


Purpose

Enables Claude AI (Claude Desktop, Claude Code, etc.) to handle MuseScore files (.mscz, .musicxml, MIDI, etc.) using natural language commands.

Features:

Category

Capabilities

Conversion & Export

Convert to PDF, PNG, MusicXML, MIDI, MP3, etc.; extract parts; export multi-page PNGs

Editing

Transpose by key or interval; instrument-specific transposition; change tempo; change time signature

Analysis

Score metadata (title, composer, time signature, key, measure count); list key signature changes; instrument and range analysis; harmony analysis (Roman numeral)

Advanced

Apply MuseScore style files (.mss); run QML plugins; create scores from MusicXML strings; MIDI → score conversion; auto-convert files in a watched folder


Requirements

  • Python 3.10 or higher

  • MuseScore 4 (or MuseScore 3) installed

    • Windows: musescore.org or Microsoft Store

    • If the installation path is not standard, specify the executable path in the MSCORE_PATH environment variable


Installation

1. Clone the repository

git clone https://github.com/strongbeen04/musescore-mcp.git
cd musescore-mcp

2. Create a virtual environment and install packages

python -m venv .venv

# Windows
.venv\Scripts\activate

# macOS / Linux
source .venv/bin/activate

# 기본 설치
pip install -e .

# 화성 분석 기능(music21) 포함 설치
pip install -e ".[harmony]"

3. Register the MCP server

Claude Desktop (Windows Store version)

Add to the %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json file:

{
  "mcpServers": {
    "musescore": {
      "command": "C:\\path\\to\\musescore-mcp\\.venv\\Scripts\\musescore-mcp.exe"
    }
  }
}

Claude Desktop (Standard installation)

Add to the %APPDATA%\Claude\claude_desktop_config.json file:

{
  "mcpServers": {
    "musescore": {
      "command": "C:\\path\\to\\musescore-mcp\\.venv\\Scripts\\musescore-mcp.exe"
    }
  }
}

Claude Code (CLI)

Add to the ~/.claude.json file:

{
  "mcpServers": {
    "musescore": {
      "type": "stdio",
      "command": "C:\\path\\to\\musescore-mcp\\.venv\\Scripts\\musescore-mcp.exe"
    }
  }
}

For macOS / Linux, change command to .venv/bin/musescore-mcp.

After saving the settings, restart Claude to connect the musescore server.


Usage

Attach a score file or provide its path while chatting with Claude. Claude will call the MCP tools internally.

Usage Examples:

"이 mscz 파일을 PDF로 변환해줘."
"악보를 Bb 클라리넷 기준으로 이조해줘."
"이 악보의 조성과 마디 수를 알려줘."
"MusicXML을 mscz 파일로 만들어줘."

Available MCP Tools

Tool

Description

get_musescore_path

Check MuseScore executable path

convert_score

Convert single file format

batch_convert

Batch convert multiple files

export_parts

Extract individual parts

export_png_pages

Export multi-page PNGs

transpose_by_key

Transpose by key

transpose_by_interval

Transpose by interval

transpose_for_instrument

Transpose for specific instrument

change_tempo

Change tempo (BPM)

change_time_signature

Change time signature

get_score_info

Return basic score information

get_key_signature

List key signature changes

list_instruments

Instrument arrangement and range

update_metadata

Modify metadata such as title and composer

analyze_harmony

Analyze harmony progression (requires music21)

apply_style

Apply MuseScore style (.mss)

run_plugin

Run QML plugin

create_from_musicxml

Convert MusicXML string → mscz

midi_to_score

Convert MIDI → mscz

watch_folder

Auto-convert after folder monitoring


Purpose

musescore-mcp is an MCP (Model Context Protocol) server that wraps the MuseScore CLI, enabling Claude AI (Claude Desktop, Claude Code, etc.) to convert, edit, and analyze music score files through natural language commands.

Features:

Category

Capabilities

Conversion & Export

Convert to PDF, PNG, MusicXML, MIDI, MP3, and more; extract individual parts; export multi-page PNGs

Editing

Transpose by key or interval; instrument-specific transposition; change tempo and time signature

Analysis

Score metadata (title, composer, key, time signature, measure count); key signature changes; instrument ranges; harmony analysis with Roman numerals

Advanced

Apply MuseScore style files (.mss); run QML plugins; create scores from MusicXML strings; convert MIDI to score; auto-convert files in a watched folder


Requirements

  • Python 3.10 or higher

  • MuseScore 4 (or MuseScore 3) installed

    • Windows: musescore.org or Microsoft Store

    • If installed to a non-standard path, set the MSCORE_PATH environment variable to the executable path


Installation

1. Clone the repository

git clone https://github.com/strongbeen04/musescore-mcp.git
cd musescore-mcp

2. Create a virtual environment and install

python -m venv .venv

# Windows
.venv\Scripts\activate

# macOS / Linux
source .venv/bin/activate

# Base install
pip install -e .

# With harmony analysis support (music21)
pip install -e ".[harmony]"

3. Register the MCP server

Claude Desktop (Windows Store)

Edit %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "musescore": {
      "command": "C:\\path\\to\\musescore-mcp\\.venv\\Scripts\\musescore-mcp.exe"
    }
  }
}

Claude Desktop (Standard install)

Edit %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "musescore": {
      "command": "C:\\path\\to\\musescore-mcp\\.venv\\Scripts\\musescore-mcp.exe"
    }
  }
}

Claude Code (CLI)

Edit ~/.claude.json:

{
  "mcpServers": {
    "musescore": {
      "type": "stdio",
      "command": "C:\\path\\to\\musescore-mcp\\.venv\\Scripts\\musescore-mcp.exe"
    }
  }
}

On macOS / Linux, change command to .venv/bin/musescore-mcp.

Restart Claude after saving the config to connect the server.


Usage

Attach a score file in your Claude conversation or describe its path, and ask in natural language. Claude will call the appropriate MCP tools automatically.

Examples:

"Convert this mscz file to PDF."
"Transpose this score for Bb clarinet."
"What is the key and measure count of this score?"
"Create an mscz from this MusicXML."

Available MCP Tools

Tool

Description

get_musescore_path

Return the detected MuseScore executable path

convert_score

Convert a single score to another format

batch_convert

Convert multiple files in one call

export_parts

Export each instrument part as a separate file

export_png_pages

Export all pages as individual PNG images

transpose_by_key

Transpose to a target key

transpose_by_interval

Transpose by a specific interval

transpose_for_instrument

Rewrite transposition for a given instrument

change_tempo

Set a new tempo (BPM)

change_time_signature

Change the time signature

get_score_info

Return title, composer, key, time sig, tempo, parts, measure count

get_key_signature

List all key signature changes with measure numbers

list_instruments

Return instrument names, transpositions, and pitch ranges

update_metadata

Edit title, composer, lyricist, and copyright fields

analyze_harmony

Analyze chord progressions (requires music21)

apply_style

Apply a MuseScore style file (.mss)

run_plugin

Execute an installed MuseScore QML plugin

create_from_musicxml

Create an mscz from a MusicXML string

midi_to_score

Convert a MIDI file to mscz

watch_folder

Monitor a folder and auto-convert new .mscz files


License

MIT

Install Server
F
license - not found
A
quality
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables natural language control over Ableton Live for generating musical patterns, melodies, and full song arrangements. It also provides tools for sample searching and mixing assistance through an OSC-based connection with Claude Desktop.
    1
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables semantic search of local audio samples by describing sounds, MIDI generation, stem separation, and other music production tools from Claude Desktop.
    1
    MIT

View all related MCP servers

Related MCP Connectors

  • Generate AI music via the Lacuna Music API from MCP clients like Claude Desktop & Code.

  • Garmin data in Claude: 135 tools — activities, sleep, HRV, training, workouts. Free, open source.

  • Connect Claude to Fathom meeting recordings, transcripts, and summaries

View all MCP Connectors

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/strongbeen04/MUSESCORE-MCP'

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