
Audionaut
Let AI agents cut, fade, analyse and export projects in the Audionaut audio editor
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"audionaut": {
"command": "npx",
"args": [
"-y",
"audionaut-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"audionaut": {
"command": "npx",
"args": [
"-y",
"audionaut-mcp"
]
}
}
}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

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
Not checked yet- Remote
- Freemium
- Design and media

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media