Audacitymcp
About
AudacityMCP connects any MCP-compatible AI assistant to [Audacity](https://www.audacityteam.org/), giving it full control over audio editing through 131 tools and 9 pipelines spanning effects, cleanup, mastering, and more. Talk to your AI assistant and it edits your audio in real
Details
- License
- Apache-2.0
Explore
- 131 tools across 11 categories (effects, editing, cleanup, mastering, transcription, etc.)
- 9 one-click pipelines for common audio tasks (podcast, music mastering, interview, etc.)
- Local transcription via faster-whisper—audio never leaves your machine
- Works with any MCP-compatible client (Claude Desktop, Claude Code, Cursor, etc.)
- Pipelines are safe—they only reduce peaks, never boost loudness
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
AudacitymcpCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Open the folder and run:
- Windows: Double-click install.bat
- macOS / Linux: Open terminal in the folder and run bash install.sh
> The installer does 3 things: installs audacity-mcp from PyPI, enables mod-script-pipe in Audacity, and configures Claude Desktop — no manual JSON editing needed.
<details>
<summary>Other MCP clients (Cursor, Claude Code, etc.)</summary>
If you're not using Claude Desktop, install manually with pip install audacity-mcp and add to your client's MCP config:
{
"mcpServers": {
"audacity": {
"command": "audacity-mcp"
}
}
}
Check your client's MCP documentation for the config file location.
</details>
pip install -e ".[dev]"
Category
Tools
| Category | Tools | Highlights |
|----------|-------|------------|
| Effects | 30 | Reverb, echo, pitch shift, tempo change, EQ, phaser, distortion, paulstretch, HPF/LPF, bass & treble, tremolo, wahwah |
| Cleanup & Mastering | 18 | Noise reduction, compressor, limiter, 9 one-click pipelines, analysis tool |
| Editing | 13 | Cut, copy, paste, split, join, trim, silence, duplicate, undo, redo |
| Project | 12 | New, open, save, import/export (WAV, MP3, FLAC, OGG, AIFF) |
| Track | 15 | Add mono/stereo, remove, set properties, mix & render, mute/solo, pan, volume |
| Selection | 12 | Select all/none/region/tracks, zero crossing, cursor positioning |
| Transport | 7 | Play, stop, pause, record, play region, get position |
| Analysis | 6 | Contrast, clipping detection, spectrum, beat finder, sound labeling |
| Generation | 5 | Tone, noise, chirp, DTMF, rhythm track |
| Transcription (Experimental) | 7 | Full/selection transcribe, to labels, to SRT/VTT/TXT, model preload |
| Labels | 6 | Add, add at time, get all, edit, import/export |
---
1. Create a module in audacity_mcp/tools/ (or add to an existing one)
2. Export a register(mcp: FastMCP) function
3. Define your tools with @mcp.tool() decorators
4. That's it — the tool registry auto-discovers it on startup
from mcp.server.fastmcp import FastMCP
from audacity_mcp_shared.error_codes import AudacityMCPError, ErrorCode
def register(mcp: FastMCP):
from audacity_mcp.main import client
@mcp.tool()
async def my_custom_effect(intensity: float = 0.5) -> dict:
"""Apply my custom effect to the selected audio."""
if not 0 <= intensity <= 1:
raise AudacityMCPError(ErrorCode.VALUE_OUT_OF_RANGE, "intensity must be 0-1")
return await client.execute_long("MyEffect", Intensity=intensity)
See CONTRIBUTING.md for full guidelines.
---
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"audacitymcp": {
"audacity": {
"command": "audacity-mcp"
}
}
}
}McpServers
{
"audacity": {
"command": "audacity-mcp"
}
}Without AudacityMCP: You manually navigate menus, tweak effect parameters by ear, apply effects one at a time, look up ACX specs, and repeat until it sounds right.
With AudacityMCP: You describe what you want in plain English and the AI handles the rest — picking the right effects, setting industry-standard parameters, and chaining operations together.
| | Manual Audacity | With AudacityMCP |
|---|---|---|
| Podcast cleanup | 5+ steps across different menus, guessing compressor settings | "Clean up this podcast" — one sentence |
| Music mastering | Research genre-appropriate EQ/compression, apply each manually | "Master this for Spotify, it's hip-hop" — genre-tuned presets |
| Noise removal | Effect → Noise Reduction → Get Profile → select all → apply | "Remove the background noise" — automatic profiling |
| Batch operations | Repetitive menu navigation for each operation | Describe the full chain and watch it happen |
| Transcription | Export audio, use external tool, import results back | "Transcribe this and add labels" — stays in Audacity |
| Learning curve | Know which effects exist and what parameters to use | Just describe the result you want |
AudacityMCP is especially useful for:
- Podcasters who want consistent, professional sound without audio engineering knowledge
- Musicians who need quick mastering with genre-appropriate settings
- Content creators working with interviews, voiceovers, or field recordings
- Anyone who'd rather describe what they want than click through menus
---
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
