Bitwig Mcp Server

Bitwig MCP Server

[](https://img.shields.io/github/v/release/jxstanford/bitwig-mcp-server) [](https://github.com/jxstanford/bitwig-mcp-server/actions/workflows/main.yml?query=branch%3Amain) [](https://codecov.io/gh/jxstanford/bitwig-mcp-server) [](https://img.shields.io/github/license/jxstanford/bitwig-mcp-server)

A Model Context Protocol (MCP) server for Bitwig Studio that allows Claude to control your DAW.

Warning! This is a work in progress. Documentation and implementation may be out of sync, and not all functionality may work as expected.

Features

• AI-Powered Music Production: Control Bitwig Studio with Claude via MCP
• Transport Controls: Play, stop, and set tempo
• Mixer Controls: Adjust volume, pan, and mute/unmute tracks
• Device Controls: Manipulate device parameters
• Project Information: Access track and device information
• Templates and Prompts: Pre-configured workflows for common tasks

Installation

Prerequisites

• Python 3.10+
• Bitwig Studio 5.2+
• Driven by Moss 5.2+
• Claude Desktop app with MCP support

Install from GitHub

# Clone the repository
git clone https://github.com/jxstanford/bitwig-mcp-server.git
cd bitwig-mcp-server

# Install dependencies
uv sync

Usage

1. Configure Bitwig Studio

1. If necessary, add a virtual MIDI device for OSC
2. Follow Driven by Moss installation instructions for Bitwig 5.2+
3. Open or restart Bitwig Studio
4. Go to Settings > Controllers
5. Click "Add Controller" and select "Open Sound Control" and "OSC"
6. Configure the receive port (default: 8000) and send port (default: 9000)
7. Enable the controller

2. Run the Bitwig MCP Server

# Run the server with default settings
python -m bitwig_mcp_server

# Or run with custom settings
python -m bitwig_mcp_server --host 127.0.0.1 --send-port 8000 --receive-port 9000 --transport stdio --debug

3. Add to Claude Desktop

# Install the server in Claude Desktop
mcp install bitwig_mcp_server/__main__.py

Then open Claude Desktop and select the Bitwig MCP Server from the MCP Servers dropdown.

Available Tools

The Bitwig MCP Server provides the following tools:

Transport Controls

• play: Toggle play/pause state or set it to a specific state
• stop: Stop playback
• set_tempo: Set the tempo in beats per minute

Track Controls

• settrackvolume: Set track volume (0-128)
• settrackpan: Set track pan position (0-128)
• settrackmute: Mute, unmute, or toggle mute state for a track

Device Controls

• setdeviceparameter: Set a device parameter value (0-128)

Information

• getprojectinfo: Get information about the current Bitwig project
• gettracksinfo: Get information about all tracks in the project
• gettrackinfo: Get information about a specific track
• getdeviceparameters: Get information about the selected device parameters

Available Resources

• bitwig://project/info: Project information
• bitwig://transport: Transport state
• bitwig://tracks: All tracks in the project
• bitwig://track/{index}: Specific track information
• bitwig://devices: Active devices
• bitwig://device/parameters: Parameters for the selected device

Example Prompts

• setupmixingsession: Set up a new mixing session with default settings
• createtracktemplate: Create a track template with specific devices and settings
• optimizetracksettings: Get recommendations for optimizing track settings

Configuration

The server can be configured through:

1. Environment variables or .env file
2. Command line arguments
3. Settings in bitwig_mcp_server/settings.py

Command Line Arguments

python -m bitwig_mcp_server --help

Development

Environment Setup

# Install dev dependencies
uv sync

# Install pre-commit hooks
uv run pre-commit install

Running Tests

# Run unit tests (no Bitwig required)
make test

# Run all tests including Bitwig integration tests
# (requires Bitwig Studio running with OSC enabled)
make test-all

Code Quality

# Run code quality checks
make check

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgements

Thanks to Jürgen Moßgraber for publishing the Driven by Moss package. This package leverages that package to interact with Bitwig.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: WeModulate
• Source: WeModulate/bitwig-mcp-server
• License: MIT

Install and usage instructions live in the source repository linked above.