Audionaut
Edit Audionaut multitrack projects: cut, fade, analyse, export.
Connector by kvoltmer · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/kvoltmer-audionaut
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Use cases: audio-video
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.
- Tools
- 1 read · 12 write · 4 delete · 5 not yet classified
- Secrets
- None asked for
- Install scripts
- None found
- Runs as
- Node.js package
Tools by what they do 22
Read from the source code; the running server may list different tools.
Read 1 · Look things up without changing anything.
get_project_info
Write 12 · Create, change, send or run things.
assembleauto_editclip_fadesclip_gainclip_speedcreate_projectcreate_regionimport_audiomove_clipplace_cliprequest_featureset_region
Delete 4 · Delete, drop, revoke or wipe things.
cleanup_regionsremove_channelremove_clipremove_track
Not yet classified 5 · We could not tell from the name and description.
analyzeexport_audioreport_bugseparate_stemssplit
Secrets and settings it asks for
Other settings (environment variables or headers).
AUDIONAUT_CLI
Files it touches
- Any path the agent passes to its tools
Tools (22)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
analyzeAnalyze audioRuns Essentia audio analysis (segment boundaries, beats, BPM) on the project's audio files - or one standalone audio file - and caches the results next to the project for auto_edit/assemble to use. Fails with essentia_unavailable in builds without Essentia. Reports progress as each file and type finishes when the call carries a progressToken.
assembleAssemble arrangementBuilds an arrangement of the given duration from the project's regions, sequentially or at random (requires regions - e.g. from auto_edit).
auto_editAuto-edit clipSegments a clip on a track using cached analysis results (run analyze first). Splits the clip into musically-aligned regions.
cleanup_regionsDelete unused regionsDeletes every region that has no clip on the timeline (the GUI's Delete Unused Regions). The audio files stay in the package.
clip_fadesSet clip fadesSets the addressed clip's fade ramps and curve exponents (0.1-4, 0.5 = equal power). All four fade values are in `unit` (default bars) and 0 clears one. Each ramp has two edges measured inward from the clip edge: the fade-in runs from fade_in_start to fade_in after the clip start, the fade-out from fade_out to fade_out_end before the clip end, so a ramp lasts fade_in - fade_in_start (or fade_out - fade_out_end). A negative offset puts that edge outside the clip, playing source audio beyond it - e.g. fade_out 0.25 with fade_out_end -0.25 (seconds) is a 0.5 s ramp centred on the clip end, the ou…
clip_gainSet clip gainSets the addressed clip's gain - linear by default, dB with db=true - on every destination channel, or one channel. The address (at or region) must match exactly one clip.
clip_speedSet clip speedSets a clip's playback speed (ratio 0.25-4, 2.0 = double speed, half as long). The mode picks how: repitch (default, varispeed - pitch and length change together) or stretch (pitch-preserving time-stretch). Mode can also be changed on its own. lockTempo ties the clip to the project tempo (speed = project tempo / clip tempo, following tempo changes); the clip tempo is detected by beat tracking or given with `tempo`, which implies the lock.
create_projectCreate projectCreates a new empty Audionaut project (.audium package) with one track. Fails if the path already exists.
create_regionCreate regionCreates a named region from a timeline range on every track whose clip fully contains it (the GUI's Create Region command). The arrangement itself is unchanged. The name must not be taken by another region (error name_taken).
export_audioExport audioRenders the project offline to an audio file (no audio device needed). The output's extension picks the format: .wav (8/16/24/32 bit), .flac (lossless and compressed, 16/24 bit, at most 8 channels per file), .aiff (8/16/24 bit), .ogg (Ogg Vorbis, lossy, at most 8 channels) or .mp3 (lossy, mono or stereo, at most 48 kHz). Lossy formats take bitrate_kbps instead of bit_depth. Pass region to bounce a single region instead - always dry, without any clip's gains or fades. Reports progress in 5% steps when the call carries a progressToken.
get_project_infoGet project infoSummarizes an Audionaut project: tempo, tracks, clips with positions/durations and their audio files. Set raw=true for the full persistence JSON instead of the summary.
import_audioImport audioImports one or more audio files into the project at the given position and saves it. Note: importing creates a new track holding the files.
move_clipMove clipMoves one clip to a new timeline position and/or onto another track. Address it by position (at) or region name; the address must match exactly one clip. to_track takes a track id, or "new" to create a track for it; without to the clip keeps its position. Give at least one of to and to_track.
place_clipPlace clipCreates a new clip from an existing named region at a timeline position, on the track that owns the region (track only disambiguates same-named regions).
remove_channelRemove channelRemoves one channel (0-based) from a track, like deleting a channel strip in the GUI. Channel mappings and per-channel clip gains shift down; the audio files stay in the package.
Show 7 more tools
remove_clipRemove clipsRemoves the clip at a timeline position (one clip; ambiguity across tracks needs track), or every placement of a named region. delete_region also drops the region itself unless other clips use it.
remove_trackRemove trackRemoves a whole track from the project, including its channels, clips and regions. Track ids are positions in the track list, so the ids of the tracks below shift up by one. The audio files stay in the package.
report_bugReport a bugReports a bug in Audionaut to the maintainer as a GitHub issue. Use it when a tool misbehaves: an error that should not happen, a wrong or inconsistent result, a crash, or a project left in a bad state. Quote the exact tool call and error text - the CLI's code and message - and say what you expected instead; that is what makes the report reproducible. Never include the audio itself, and keep file paths to what is needed. Tell the user you are sending it; include their name or e-mail only if they offered it. If nothing could be sent, the reply carries a prefilled issue link to hand to the user.
request_featureRequest a featureSends a feature request to the Audionaut maintainer as a GitHub issue. Use it when a task needs something the other tools cannot do: a missing verb or option, a limit that got in the way, or a workflow that took a clumsy workaround. Say what the user was trying to achieve and why the current tools fall short - that context is what makes the request actionable. Tell the user you are sending it; include their name or e-mail only if they offered it. If nothing could be sent, the reply carries a prefilled issue link to hand to the user.
separate_stemsSeparate stemsSplits a clip into Drums/Bass/Other/Vocals tracks with the Demucs (htdemucs) source separator, aligned with the source clip. Slow: minutes for a full song, CPU only; reports progress in 5% steps when the call carries a progressToken. Needs the model weights, which the Audionaut app downloads once (Settings > Separation); fails with model_missing until then, and with demucs_unavailable in builds without Demucs.
set_regionEdit regionRenames a region and/or retrims its source-relative range (clamped to the source audio). Clips have no length of their own, so a retrim affects every clip using the region.
splitSplit clipsSplits the clip under the given timeline position into two on every track that has one there (the GUI's Split command). Fails with nothing_to_split when no clip spans the position.
Compare and alternatives
Featured in
Signals
- Stars
- 265
- Forks
- 14
- Open issues
- 16
- Last commit (this folder)
- Oct 21, 2026 (6 days ago)
- Last release
- Oct 25, 2026 (2 days ago)
From GitHub (fetched Oct 24, 2026).
Details
- Registry name
io.github.kvoltmer/audionaut- Version
- 0.5.0
- Auth
- No auth
- Packages
- npm audionaut-mcp
- License
- License unknown
- Repository
- github.com/kvoltmer/Audionaut
- First seen
- Oct 24, 2026
- Last checked
- Oct 26, 2026
Cite this page
Audionaut MCP server. Agent Mart. https://agentmart.dev/connectors/kvoltmer-audionaut (last updated 2026-10-26)