Skip to content
MCP server

Woven

Lets Claude Code or Codex make and edit videos in the Woven Mac editor

Runs locallyStatus and history
Install
Pricing
Free trial
Platforms
macOS, CLI
Runs
Locally
Version
0.1.0
Listing updated
2 days ago

About Woven

Woven is an MCP server for design and media. It runs locally on your machine and is started by your AI client.

This connector is a thin bridge to Woven, a native macOS video editor. It runs locally, finds Woven in /Applications or ~/Applications and starts the connector bundled inside the app, so it does not work from chat apps or cloud sessions. The README notes that Woven has no public web API.

Through it an agent can pull clips from your Mac into a workspace, look at the footage and transcribe it, build and edit reels, check frames, add captions, generate images, video and audio, and export. The tools come from the Woven app and change as it updates; the README lists them for version 0.2.47. Five of them spend Woven credits, and the generation and transcription tools ask your AI app to get your go-ahead before first paid use.

You need macOS 15 or later, Woven installed and a Woven plan or the 3-day free trial, which requires a card. Woven's plans start at $15 a month for Starter and $39 a month for Pro, or $129 and $299 billed yearly.

Install

Run in a terminal

claude mcp add woven -- npx -y @woven-video/mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "woven": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@woven-video/mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "woven": {
      "command": "npx",
      "args": [
        "-y",
        "@woven-video/mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "woven": {
      "command": "npx",
      "args": [
        "-y",
        "@woven-video/mcp"
      ]
    }
  }
}

Tools this server provides (29)

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

list_workspaces
Lists Woven workspaces; the place to start.
create_workspace
Creates a workspace.
list_files
Lists files in a workspace.
read_text_file
Reads a text file.
import_media
Brings media into a workspace.
download_file
Downloads a file.
download_video
Downloads a video.
read_image
Reads an image.
get_video_frames
Gets frames from a video.
analyze_video
Analyses footage.
transcribe_media
Transcribes media.
extract_audio
Extracts audio.
identify_song
Identifies a song.
list_reels
Lists reels.
read_reel
Reads a reel.
write_reel_spec
Writes a reel spec.
get_reel_frames
Gets frames from a reel.
export_reel
Exports a reel.
open_in_woven
Opens a project in Woven.
read_woven_guide
Reads the Woven guide.
list_sfx_library
Lists the sound effects library.
generate_captions
Generates captions.
edit_caption_words
Edits caption words.
list_media_models
Lists media models.
generate_image
Generates an image.
generate_video
Generates a video.
generate_audio
Generates audio.
get_generation_status
Checks a generation job.
cancel_generation
Cancels a generation job.

What it does

Local launcher
Starts the connector inside the Woven app over stdio.
Footage analysis
Tools read frames, analyse video, transcribe media and identify songs.
Reel editing
Write a reel spec, read frames back and export the result.
Captions
Generate captions and edit individual caption words.
Media generation
Create images, video and audio with status and cancel controls.
Credit prompts
Paid generation and transcription ask for approval before first use.

Good for

  • Ask Claude Code to cut a YouTube video from raw footage
  • Add captions to a Reel or Short from an agent
  • Generate B-roll images or clips and place them in a project
  • Transcribe a recording and find the right moments to cut
  • Export a finished reel without leaving the terminal

Pricing

Free trial, from $15 a month

3-day free trial (card required); Starter $15/mo, Pro $39/mo; $129 or $299 a year

Prices change. Check woven.video before you buy.

Woven FAQ

Does it work in claude.ai or ChatGPT?

No. It is a local server and Woven has no public web API, so chat apps and cloud sessions are not supported.

What do I need installed?

macOS 15 or later, Woven in Applications, a Woven account with a plan or trial, and an AI app that runs local MCP servers.

What does it cost?

Woven offers Starter at $15 a month and Pro at $39 a month, each with a 3-day free trial that needs a card.

Which tools spend credits?

Five: the three generators, captions and transcription.

Is Woven free?

Woven is a paid product with a free trial. Paid plans start at $15 a month.

How do I add Woven to Claude Code?

Run this command in your terminal: claude mcp add woven -- npx -y @woven-video/mcp

What are the best alternatives to Woven?

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

Alternatives to Woven

  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