# demusic

> demusic is an open-source MCP server for design and media. Strips AI-baked background music from video clips while keeping dialogue and sound effects. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows
- **Website:** https://dawnwood.ai/open-source/
- **Repository:** https://github.com/dawnwood-ai/demusic
- **GitHub stars:** 0
- **License:** Apache-2.0
- **MCP Registry name:** io.github.dawnwood-ai/demusic
- **Categories:** design and media
- **Listing updated:** 2026-11-15

## About

Native-audio video models often add a music bed nobody asked for, and cutting several such clips together leaves competing scores. demusic locates where the music is and replaces only those seconds, leaving the rest of the audio untouched and copying the picture stream without re-encoding.

Detection runs in steps: separate stems with Demucs, either locally or through your own fal key, check that the melodic stems are loud enough, then require an AudioSet classifier to hear music for two seconds in a row so engine hum, gunfire and room tone do not count. Inside detected spans the audio becomes dialogue plus impacts with a 0.25 second crossfade. The README reports 2 false positives on 164 clips with no music, and 33 of 87 clips flagged by ear, with misses mostly very quiet beds.

The CLI has check and strip commands, with check exiting 1 when music is found so it can fail a build. It needs Python 3.10 or newer and ffmpeg, and comes from a studio that releases its production tools under Apache-2.0.

## Features

- **Span-only replacement:** Only the seconds containing music are altered.
- **No video re-encode:** The picture stream is copied unchanged.
- **Conservative detection:** A loudness gate and a music classifier guard against false positives.
- **Pipeline-friendly check:** demusic check exits 1 when a clip has music and supports JSON output.
- **Separator choice:** Use local Demucs, fal.ai with your key, or stems you already made.
- **Tunable modes:** Spans, whole-track or forced replacement, with an adjustable threshold.

## Good for

- Clean music from AI-generated drama clips
- Fail a render pipeline when a clip contains a music bed
- Prepare clips before laying your own score
- Batch-process a folder of renders

## Install

### Claude Code (Terminal)

```sh
claude mcp add demusic --env FAL_KEY='<FAL_KEY>' -- uvx demusic
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "demusic": {
      "command": "uvx",
      "args": [
        "demusic"
      ],
      "env": {
        "FAL_KEY": "<FAL_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "demusic": {
      "command": "uvx",
      "args": [
        "demusic"
      ],
      "env": {
        "FAL_KEY": "<FAL_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "demusic": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "demusic"
      ],
      "env": {
        "FAL_KEY": "<FAL_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "demusic": {
      "command": "uvx",
      "args": [
        "demusic"
      ],
      "env": {
        "FAL_KEY": "<FAL_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "demusic": {
      "command": "uvx",
      "args": [
        "demusic"
      ],
      "env": {
        "FAL_KEY": "<FAL_KEY>"
      }
    }
  }
}
```

## FAQ

### What does it need installed?

Python 3.10 or newer and ffmpeg, plus Demucs locally or a fal.ai key.

### Does it remove sound effects too?

No. It keeps dialogue, impacts and ambience.

### Is it free?

The studio publishes it as a free Apache-2.0 tool.

### What if it misses quiet music?

Lower the threshold or use force mode.

### Is demusic free?

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

### How do I add demusic to Claude Code?

Run this command in your terminal: claude mcp add demusic --env FAL_KEY='<FAL_KEY>' -- uvx demusic

### What are the best alternatives to demusic?

The closest alternatives to demusic 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/demusic
