musescore-mcp
Provides tools for converting, editing, and analyzing MuseScore score files (.mscz, MusicXML, MIDI, etc.) through MuseScore's CLI, enabling operations like format conversion, transposition, tempo change, instrument part extraction, harmony analysis, and more.
Click on "Install 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., "@musescore-mcptranspose this score for Bb clarinet"
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.
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_PATHenvironment variable
Installation
1. Clone the repository
git clone https://github.com/strongbeen04/musescore-mcp.git
cd musescore-mcp2. 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 |
| Check MuseScore executable path |
| Convert single file format |
| Batch convert multiple files |
| Extract individual parts |
| Export multi-page PNGs |
| Transpose by key |
| Transpose by interval |
| Transpose for specific instrument |
| Change tempo (BPM) |
| Change time signature |
| Return basic score information |
| List key signature changes |
| Instrument arrangement and range |
| Modify metadata such as title and composer |
| Analyze harmony progression (requires music21) |
| Apply MuseScore style (.mss) |
| Run QML plugin |
| Convert MusicXML string → mscz |
| Convert MIDI → mscz |
| 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_PATHenvironment variable to the executable path
Installation
1. Clone the repository
git clone https://github.com/strongbeen04/musescore-mcp.git
cd musescore-mcp2. 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 |
| Return the detected MuseScore executable path |
| Convert a single score to another format |
| Convert multiple files in one call |
| Export each instrument part as a separate file |
| Export all pages as individual PNG images |
| Transpose to a target key |
| Transpose by a specific interval |
| Rewrite transposition for a given instrument |
| Set a new tempo (BPM) |
| Change the time signature |
| Return title, composer, key, time sig, tempo, parts, measure count |
| List all key signature changes with measure numbers |
| Return instrument names, transpositions, and pitch ranges |
| Edit title, composer, lyricist, and copyright fields |
| Analyze chord progressions (requires music21) |
| Apply a MuseScore style file (.mss) |
| Execute an installed MuseScore QML plugin |
| Create an mscz from a MusicXML string |
| Convert a MIDI file to mscz |
| Monitor a folder and auto-convert new .mscz files |
License
MIT
Maintenance
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
- AlicenseNot gradedqualityDmaintenanceEnables Claude AI to generate professional, production-ready MIDI files (chord progressions, drum patterns, bass lines, melodies, and full arrangements) compatible with any DAW including Logic Pro, Ableton Live, FL Studio, and more.7MIT
- AlicenseNot gradedqualityDmaintenanceEnables 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.1MIT
- FlicenseNot gradedqualityCmaintenanceEnables natural language control of Ableton Live through Claude, including session management, track and clip creation, device parameter adjustment, and browser browsing.1
- AlicenseNot gradedqualityDmaintenanceEnables semantic search of local audio samples by describing sounds, MIDI generation, stem separation, and other music production tools from Claude Desktop.1MIT
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
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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