# Woven

> Woven is an MCP server for design and media. Lets Claude Code or Codex make and edit videos in the Woven Mac editor. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Starting price:** $15 a month
- **Platforms:** macOS, CLI
- **Website:** https://www.woven.video
- **Repository:** https://github.com/woven-video/woven-mcp
- **MCP Registry name:** io.github.woven-video/woven
- **Categories:** design and media
- **Listing updated:** 2026-11-15

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

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

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

- [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/woven
