How do I use lmms-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@lmms-mcp Create a new LMMS project, set tempo to 90 BPM, and add a basic drum pattern." 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.

lmms-mcp

by TypeWolf

Overview Schema Related Servers Score Discussions

Python

LMMS MCP Server

An MCP (Model Context Protocol) server for LMMS - the free, open-source digital audio workstation. Lets AI agents create, modify, and save LMMS music projects programmatically.

Features

Create & save LMMS projects (.mmpz compressed, .mmp XML)
Add tracks: Instrument, Sample, Pattern (Beat/Bassline), Automation
Add notes with MIDI key, position, velocity, and panning
Effects: 18 built-in effects on tracks and mixer channels (delay, reverb, EQ, compressor...)
ZynAddSubFX presets: Load any of ~950 factory instruments (.xiz), tune parameters
Arrangement: Place patterns, BB clips and audio clips on the song timeline
Automation: Tempo ramps, volume swells, panning curves - linked to real LMMS models
Mixer control: Create channels, set volume, name channels
Song settings: Tempo (BPM), time signature, master volume/pitch
Musical utilities: Note name conversion, scale generation, tick/bar conversion
Full project inspection: Read tracks, patterns, notes, mixer channels

Related MCP server: FL Studio MCP Server

Installation

pip install lmms-mcp

Or from source:

git clone https://github.com/TypeWolf/lmms-mcp.git
cd lmms-mcp
pip install -e .

Requirements

Python 3.10+
An MCP host (opencode, Claude Desktop, Cursor, etc.)

Quick Start

With opencode

Add to your opencode.json:

{
  "mcp": {
    "lmms": {
      "type": "local",
      "command": ["python", "-m", "lmms_mcp"],
      "environment": {
        "LMMS_PROJECTS_DIR": "/path/to/your/lmms/projects"
      }
    }
  }
}

With Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "lmms": {
      "command": "python",
      "args": ["-m", "lmms_mcp"],
      "env": {
        "LMMS_PROJECTS_DIR": "/path/to/your/lmms/projects"
      }
    }
  }
}

Run directly

python -m lmms_mcp

Tools

Project Management

Tool	Description
`create_project`	Create a new empty LMMS project
`load_project`	Load an existing `.mmpz` or `.mmp` file
`save_project`	Save the current project
`get_project_info`	Get project overview (tempo, tracks, mixer)
`get_project_xml`	Get raw XML of the project

Track Operations

Tool	Description
`add_instrument_track`	Add a synthesizer/sampler track
`add_sample_track`	Add an audio sample track
`add_automation_track`	Add a parameter automation track
`add_pattern_track`	Add a beat/bassline pattern track
`remove_track`	Remove a track by index
`get_track`	Get detailed track information
`list_tracks`	List all tracks with summary
`set_track_volume`	Set track volume (0-200)
`set_track_panning`	Set track panning (-100 to +100)
`mute_track`	Mute/unmute a track
`solo_track`	Solo/unsolo a track

Notes & Patterns

Tool	Description
`add_note`	Add a note by MIDI key number
`add_note_by_name`	Add a note by name (e.g. "C4", "A#3")
`add_notes_batch`	Add multiple notes at once

Mixer

Tool	Description
`add_mixer_channel`	Create a new mixer channel
`get_mixer_channels`	List all mixer channels
`set_mixer_channel_volume`	Set channel volume
`set_mixer_channel_name`	Rename a channel

Song Settings

Tool	Description
`set_tempo`	Set BPM (10-999)
`set_time_signature`	Set time signature (e.g. 4/4, 3/4)
`set_master_volume`	Set master volume (0-200)
`set_master_pitch`	Set master pitch (-12 to +12 semitones)

Effects (FX Chain)

Tool	Description
`add_effect`	Add a built-in effect to a track or mixer channel
`remove_effect`	Remove an effect by name or chain position
`toggle_effect`	Enable/bypass an effect without removing it
`get_effect_chain`	List all effects on a track or mixer channel

ZynAddSubFX Presets & Parameters

Tool	Description
`list_zyn_presets`	Browse ~950 factory presets (.xiz) by category
`load_zyn_preset`	Load a preset into a zynaddsubfx track
`set_zyn_params`	Set portamento, filter, FM gain, resonance etc.

Arrangement (Song Editor Timeline)

Tool	Description
`place_pattern`	Place an empty pattern clip on an instrument track
`place_bb_clip`	Trigger a BB pattern at a given time
`place_sample_clip`	Place an audio file clip on a sample track
`assign_sample_file`	Assign/replace the audio file on sample clips
`move_clip`	Move a clip to a new position
`delete_clip`	Delete a clip at a position
`get_arrangement`	Full timeline overview of all clips

Automation

Tool	Description
`add_automation`	Create automation curves for tempo, master volume/pitch, track volume/panning and mixer channel volume

LMMS App Integration

Tool	Description
`get_lmms_info`	Detect installed LMMS version + available plugins
`render_project`	Export to WAV/FLAC/OGG/MP3 via headless LMMS render

The server reads and writes project files directly - it never launches the LMMS GUI. The installed LMMS is only used for: preset discovery, plugin availability checks (warns about plugins your version lacks, e.g. SlicerT/Xpressive require LMMS 1.3+) and audio rendering.

Custom Plugins & VST

Tool	Description
`list_available_plugins`	Dynamically list ALL installed plugins (incl. custom ones)
`scan_vst_directory`	Find VST .dll files in a folder
`add_vst_track`	Add a track hosting a VST plugin (Vestige)

Custom LMMS plugins dropped into the plugins folder are detected automatically and can be used directly by name - no server update needed.

Utilities

Tool	Description
`note_name_to_key`	Convert note name to MIDI number
`key_to_note_name`	Convert MIDI number to note name
`bars_to_ticks_converter`	Convert bars to ticks
`ticks_to_bars_converter`	Convert ticks to bars
`generate_scale`	Generate a musical scale

Resources

URI	Description
`lmms://project/info`	Current project information
`lmms://project/tracks`	All tracks in the project
`lmms://project/mixer`	All mixer channels
`lmms://project/xml`	Raw project XML
`lmms://reference/instruments`	Available LMMS instruments
`lmms://reference/effects`	Available LMMS effects
`lmms://reference/note_names`	MIDI note name mapping
`lmms://reference/scales`	Available musical scales

Prompts

Name	Description
`create_basic_song`	Create a song structure with drums, bass, melody
`add_drum_pattern`	Generate a drum pattern (four-on-the-floor, breakbeat, etc.)
`create_melody`	Generate a melody in a given scale
`mix_and_arrange`	Mix and arrange the current project
`export_project`	Export/save the project

LMMS Concepts

Concept	Value
Ticks per bar	192 (in 4/4 time)
Default tempo	140 BPM
Note 60	C4 (middle C)
Note 69	A4 (440 Hz)
Volume range	0-200 (100 = normal)
Panning range	-100 (left) to +100 (right)
Track type 0	Instrument
Track type 1	Pattern (Beat/Bassline)
Track type 2	Sample
Track type 5	Automation

Available Instruments

All built-in LMMS instruments (verified against LMMS source). LMMS has no plugin download mechanism - only these can be used:

Plugin ID	Name
`tripleoscillator`	Three-oscillator subtractive synth (default)
`kicker`	Kick drum synth
`audiofileprocessor`	Audio file player/sampler
`organic`	Additive organ synth
`malletsstk`	Physical modeling mallets (STK)
`lb302`	TB-303 style acid bass
`monstro`	Powerful 3-oscillator polyphonic synth
`freeboy`	Game Boy sound chip emulator
`nes`	NES 8-bit sound chip emulator
`sid`	Commodore 64 SID chip emulator
`sfxr`	Retro sound effect generator
`opulenz`	OPL3 FM synthesizer
`watsyn`	4-oscillator wavetable-style synth
`xpressive`	Expressive mono lead synth
`zynaddsubfx`	ZynAddSubFX powerful feature-rich synth
`sf2player`	SoundFont (.sf2) sample player
`vibedstrings`	Vibrating string physical model
`bitinvader`	Bit-crushed wavetable synth
`patman`	GUS patch sampler
`gigplayer`	GIG sample library player
`slicert`	Beat slicer for audio loops
`vestige`	VST plugin host (Windows only)

Available Effects

Built-in LMMS effects for add_effect: amplifier, bassbooster, bitcrush, compressor, crossovereq, delay, dispersion, dualfilter, dynamicsprocessor, eq, flanger, frequencyshifter, multitapecho, reverbsc, slewdistortion, stereoenhancer, stereomatrix, waveshaper.

Typical chains:

Lead synth: delay -> reverbsc
Vocals: eq -> compressor -> reverbsc
Master bus: eq -> compressor -> stereoenhancer

Environment Variables

Variable	Default	Description
`LMMS_PROJECTS_DIR`	`~/Desktop/Media/lmms/AI-Projects`	Default directory for saving projects
`LMMS_PRESETS_DIR`	auto-detected	Path to ZynAddSubFX presets folder (`data/presets/ZynAddSubFX`)
`LMMS_EXECUTABLE`	auto-detected	Path to `lmms.exe` (for version/plugin checks and rendering)

Configuration

opencode.json

{
  "mcp": {
    "lmms": {
      "type": "local",
      "command": ["python", "-m", "lmms_mcp"],
      "cwd": ".",
      "enabled": true,
      "environment": {
        "LMMS_PROJECTS_DIR": "C:\\Users\\you\\Music\\LMMS\\Projects"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "lmms": {
      "command": "python",
      "args": ["-m", "lmms_mcp"],
      "env": {
        "LMMS_PROJECTS_DIR": "/home/you/music/lmms/projects"
      }
    }
  }
}

Development

# Clone and install
git clone https://github.com/TypeWolf/lmms-mcp.git
cd lmms-mcp
pip install -e ".[dev]"

# Run tests
pytest

# Run in development mode
mcp dev src/lmms_mcp/server.py

License

MIT License - see LICENSE for details.

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

Links

LMMS - The DAW this server controls
MCP Protocol - Model Context Protocol specification
MCP Python SDK - Official Python SDK
opencode - AI coding assistant with MCP support

This server cannot be installed

license - permissive license

Not graded

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Related MCP Servers

FL Studio MCP Server
Multimedia Processing Audio Processing App Automation
karl-andres
A
license
Not graded
quality
B
maintenance
Enables AI assistants to control FL Studio through MIDI communication, providing transport control, mixer adjustments, channel rack manipulation, plugin parameter automation, and piano roll note editing capabilities.
Updated 19 days ago (2026-08-03 00:46 UTC)
105
MIT
FL Studio MCP Server
Multimedia Processing Audio Processing AI & Machine Learning
404kidwiz
A
license
Not graded
quality
C
maintenance
Real-time AI-assisted music production, advanced composition, mixing, and VST coordination for FL Studio via bidirectional MIDI & WebSockets, exposing over 100 tools for comprehensive DAW control.
Updated 2 months ago (2026-06-13 03:11 UTC)
8
MIT
reascript-mcp
Audio Processing Multimedia Processing
cclawton
F
license
Not graded
quality
B
maintenance
Enables AI agents to control Reaper DAW by parsing .rpp project files and generating Lua ReaScripts for project-level tasks.
Updated a month ago (2026-07-11 08:23 UTC)
opendaw-mcp
Audio Processing Multimedia Processing
AMEOBIUS-team
A
license
B
quality
A
maintenance
Enables AI agents to control a browser-based digital audio workstation (openDAW) for music production, including track creation, effects, MIDI, automation, and rendering.
Updated a month ago (2026-07-12 17:29 UTC)
100
Apache 2.0

View all related MCP servers

Related MCP Connectors

Keyboardia
Create, co-edit, analyze, publish, and export collaborative step-sequencer sessions through MCP.
Lacuna Music
Generate AI music via the Lacuna Music API from MCP clients like Claude Desktop & Code.
Compeller
Create and track AI music videos and audio-reactive visuals from songs.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

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/TypeWolf/lmms-mcp'

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

LMMS MCP Server

Features

Installation

Requirements

Quick Start

With opencode

With Claude Desktop

Run directly

Tools

Project Management

Track Operations

Notes & Patterns

Mixer

Song Settings

Effects (FX Chain)

ZynAddSubFX Presets & Parameters

Arrangement (Song Editor Timeline)

Automation

LMMS App Integration

Custom Plugins & VST

Utilities

Resources

Prompts

LMMS Concepts

Available Instruments

Available Effects

Environment Variables

Configuration

opencode.json

claude_desktop_config.json

Development

License

Contributing

Links

Maintenance

Resources

Looking for Admin?

Related MCP Servers

FL Studio MCP Server

FL Studio MCP Server

reascript-mcp

opendaw-mcp

Related MCP Connectors

Latest Blog Posts

MCP directory API