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.