Skip to content
MCP server

Audionaut

Let AI agents cut, fade, analyse and export projects in the Audionaut audio editor

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, Windows, Linux
Runs
Locally
Version
0.5.0
Listing updated
2 days ago

About Audionaut

Audionaut is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

This server is a thin wrapper around Audionaut's command-line verbs: each tool call runs one command with JSON output and passes the result back, and no editing logic lives in the package. It does nothing by itself and needs the Audionaut desktop app installed, plus Node.js 18 or later.

The interesting part is how it treats a project that is open. The running app serves the command, so the agent works on the document as you see it, unsaved changes included, and the edit lands as a single undo step with the window title marked Edited By Agent. If you edit while a command runs, the agent's result is dropped and it is told to retry, and if the app holds the project but cannot be reached the command fails instead of overwriting the file.

On macOS the app is sandboxed to the Music folder, so projects, imported audio and export targets must live under ~/Music; the server rejects other paths with sandbox_denied. A --check flag reports which Audionaut binary it found.

Install

Run in a terminal

claude mcp add audionaut -- npx -y audionaut-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "audionaut": {
      "command": "npx",
      "args": [
        "-y",
        "audionaut-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "audionaut": {
      "command": "npx",
      "args": [
        "-y",
        "audionaut-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "audionaut": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "audionaut-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "audionaut": {
      "command": "npx",
      "args": [
        "-y",
        "audionaut-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "audionaut": {
      "command": "npx",
      "args": [
        "-y",
        "audionaut-mcp"
      ]
    }
  }
}

Configuration

  • AUDIONAUT_CLIPath to the Audionaut app binary or audionaut-cli, if it is not found automatically

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

get_project_info
Tempo, tracks, clips and files, or the raw project JSON.
create_project
Create a new empty project package.
import_audio
Add audio files, creating a new track.
export_audio
Render offline to WAV, FLAC, AIFF, Ogg Vorbis or MP3.
analyze
Segment, beat and onset analysis.
auto_edit
Segment a clip at analysed boundaries.
separate_stems
Split audio into stems using the Demucs model.

What it does

Edits as undo steps
When the project is open, each agent task becomes one entry in the app's undo history.
Your edits win
If you change the project mid-command, the agent's result is dropped and it must re-run.
Audio export
Render to WAV, FLAC, AIFF, Ogg Vorbis or MP3 offline.
Analysis and auto-edit
Run segment, beat and onset analysis, then segment clips at analysed boundaries.
Stem separation
Split a song into stems using the Demucs model downloaded in the app.
Progress reporting
Separation, export and analysis report progress when the client sends a progress token.

Good for

  • Split a clip every 16 bars from a plain-language request
  • Remove pauses from a spoken-word recording
  • Bounce a project to MP3 or FLAC without opening export dialogs
  • Analyse beats and onsets in a track and cut at the boundaries
  • Separate stems from a song for remixing

Pricing

Open source

Audionaut is described as a free, open-source desktop application; this server is a wrapper for it.

Prices change. Check audionaut.app before you buy.

Audionaut FAQ

Does it work without the Audionaut app?

No. The README says the package does nothing on its own and requires the app.

How do I add it to Claude Code?

Run claude mcp add audionaut -- npx -y audionaut-mcp.

Where must macOS projects live?

Inside ~/Music, for example ~/Music/Audionaut, because the sandboxed app can only reach that folder.

Will it overwrite a project I have open?

No. It hands the command to the running app, and fails with host_unavailable rather than writing the file if the app cannot be reached.

Is the stem model free to use commercially?

The README says the Demucs model weights are licensed for research use.

Is Audionaut free?

Yes. Audionaut is open source, so you can use and self-host it for free.

How do I add Audionaut to Claude Code?

Run this command in your terminal: claude mcp add audionaut -- npx -y audionaut-mcp

What are the best alternatives to Audionaut?

The closest alternatives to Audionaut are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

Alternatives to Audionaut

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media