# Audionaut

> Audionaut is an open-source MCP server for design and media. Let AI agents cut, fade, analyse and export projects in the Audionaut audio editor. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Windows, Linux, CLI
- **Website:** https://audionaut.app/manual/11-cli-and-agents/
- **Repository:** https://github.com/kvoltmer/audionaut/tree/HEAD/Tools/audionaut-mcp
- **MCP Registry name:** io.github.kvoltmer/audionaut
- **Categories:** design and media
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add audionaut -- npx -y audionaut-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/audionaut
