knooth-mcp

MCP server for Knooth video editor — natural language video editing.

Edit videos by talking to your AI tool. Add titles, trim clips, apply transitions, generate captions, remove filler words, and more — all through natural language.

Prerequisites

• Knooth running with a project open
• Python 3.10+
• uv — fast Python package manager

Install uv

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Homebrew
brew install uv

After installing, uvx is available automatically — no extra steps.

Client Setup

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "knooth": {
      "command": "uvx",
      "args": ["knooth-mcp"]
    }
  }
}

Restart Claude Desktop. The hammer icon appears — click it to see Knooth tools.

Claude Code

claude mcp add knooth -- uvx knooth-mcp

Add --scope user to make it available across all projects. Verify with /mcp.

Cursor

Edit ~/.cursor/mcp.json (global) or .cursor/mcp.json (per-project):

{
  "mcpServers": {
    "knooth": {
      "command": "uvx",
      "args": ["knooth-mcp"]
    }
  }
}

Open Cursor Settings → MCP → confirm Knooth shows as connected.

VS Code (Copilot)

Edit .vscode/mcp.json in your workspace (or use Command Palette → MCP: Add Server):

{
  "servers": {
    "knooth": {
      "command": "uvx",
      "args": ["knooth-mcp"]
    }
  }
}

Click "Start" next to the server entry.

Note: VS Code uses "servers", not "mcpServers".

Codex

codex mcp add knooth -- uvx knooth-mcp

Or edit ~/.codex/config.toml:

[mcp_servers.knooth]
command = "uvx"
args = ["knooth-mcp"]

Verify with /mcp in the Codex TUI.

What You Can Do

Design Presets

Ask your AI tool to "use style-1" (or style-2, style-3) before adding visual elements:

Place a custom DESIGN.md in your Knooth project folder to use your own brand guidelines instead.