musescore-mcp
If you are the rightful owner of musescore-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
The MuseScore MCP Server integrates MuseScore with LLM clients like Claude Desktop, enabling basic music composition through natural language.
MuseScore MCP Server
This MCP (Model Context Protocol) server integrates MuseScore with LLM clients like Claude Desktop, enabling basic music composition through natural language.
Brief demo here: https://www.canva.com/design/DAGlHeR706g/4UcXvK23I1axWOfm6lSSxQ/edit
Features
The server allows an MCP-connected LLM to:
- Connect to MuseScore and manipulate an open score
- Add notes and rests
- Select and delete
- Create tuplets
- Undo a change
- Move from staff to staff
Limitations
- Can not understand multiple voices within a staff or navigate between them
Requirements
- Python 3.9+
- MuseScore 3 or 4 installed
- MCP Python SDK
Installation
-
Clone this repository:
git clone https://github.com/yourusername/musescore-mcp-server.git cd musescore-mcp-server -
Install dependencies, either in a venv or globally:
pip install -r requirements.txt -
Install the musescore-mcp-plugin by copying it into your MuseScore plugins dir (on my mac this was ~/Documents/MuseScore4/plugins)
-
Configure your LLM with the MCP server (server.py). If you are using Claude Desktop and a venv, this can be done by creating a claude_desktop_config file like so:
{ "mcpServers": { "musescore": { "command": "bash", "args": [ "-c", "source /path/to/venv/activate && python3 /path/to/server.py" ] } }
Usage
Prepare MuseScore
Open musescore and whatever score you want to use. Then, connect the musescore-mcp-plugin and launch it by selecting it from the plugins menu.
Example Queries
Once connected, you can ask Claude questions like:
- "Help me come up with some possible chords for the melody in my score
- Compose a simple melody and show me 4 ways to harmonize it
- Extend the melody in measures 1-12 with 4 measures that match the style of this piece
Development
If you want to add features to the MuseScore plugin and test them, the testClient.html file in this repo may be a useful development tool - simply extend it to call whatever functions you add.
