Woven

io.github.woven-videoPublished by GitHub account woven-videov0.1.0Updated Oct 26, 2026

Make and edit videos in Woven, the AI video editor for Mac. Needs the Woven app.

VerifiedSTDIODesktop onlyMedia & DesignAI & ML

Overview

AI-generated overview

Connector that lets AI apps on a Mac create and edit videos in Woven, the AI video editor, through a local MCP server.

What you can do
  • Find clips on the Mac, import media into workspaces and download files or videos
  • Inspect footage, transcribe media, extract audio and identify songs
  • Build and edit reels, render frames, export reels and open them in Woven
  • Generate and edit captions
  • Generate images, video and audio with media models, and check or cancel generation jobs
When to use it
Useful when you want an AI app such as Claude Code or Codex to assemble and edit video projects in Woven on a Mac, from short reels and TikToks to longer videos and podcasts, without switching to the editor for every step.
Requirements
macOS 15 or later with Woven installed in /Applications or ~/Applications, and an AI app that runs local MCP servers. The npm package is a launcher and needs Node.js for npx; alternatively point the app directly at the connector inside the Woven app. A signed-in Woven account with a plan or the 3-day free trial (card required) is needed for all tools except the guide reader.
Before you install
Woven does the editing and rendering using your Woven account and credits; the three generators, captions and transcription spend credits, and the trial requires a card. Tools can import media, write reel specs, export reels and generate content, so changes affect your Woven workspaces. It only works locally on a Mac and not in cloud or web sessions.

Installation

In SourceWeft

  1. Open Woven in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Woven MCP connector

Woven Video is an AI video editor for Mac. You import your footage, ask for the edit in chat, and fine-tune it on a real timeline. It's a full editor for long and short videos alike: YouTube videos and Shorts, podcasts, gaming videos, Reels, TikToks and more.

This connector lets AI apps on your Mac, such as Claude Code and Codex, make and edit videos in Woven. Through it, the app can:

  • find clips on your Mac and bring them into a workspace
  • look at the footage
  • build and edit reels, and check frames
  • add captions
  • make images, video and audio
  • export

Woven does the editing and rendering, using your Woven account and credits.

It is a local MCP server: your AI app starts it on your Mac, and it talks to the Woven app there. Woven has no public web API, so the connector doesn't work in chat apps or in cloud and web sessions.

Requirements

  • macOS 15 or later.
  • Woven installed in /Applications or ~/Applications.
  • A Woven account with a plan or the 3-day free trial (card required). See pricing.
  • An AI app that runs local MCP servers on your Mac.

Set up

Recommended: paste the setup prompt

Copy the prompt for your app from woven.video/setup.md and paste it into that app on your Mac, once. The same prompts are in Woven under Settings → AI apps.

The prompt:

  1. checks that it is running on a Mac;
  2. installs Woven with Homebrew, only if you agree;
  3. adds Woven's connector to the app;
  4. opens Woven so you can sign in.

That route doesn't need this package or Node.js.

Manual: use this package

This package is a small launcher. It finds Woven on your Mac and starts the connector that ships inside the app. It needs Node.js for npx.

  1. Install Woven. Either download it and move it to Applications, or run:

    bash
    brew install --cask woven-video/tap/woven

  2. Open Woven once and sign in.

  3. Add the connector to your AI app.

Claude Code

bash
claude mcp add --scope user woven -- npx -y @woven-video/mcp

Codex

bash
codex mcp add woven -- npx -y @woven-video/mcp

Other apps that take a JSON MCP config, such as Cursor:

json
{  "mcpServers": {    "woven": {      "command": "npx",      "args": ["-y", "@woven-video/mcp"]    }  }}
  1. Restart the app, or start a new session, so it loads the Woven tools.
  2. Ask it to list your Woven workspaces.

You can also skip this package and point your app straight at the connector. That is what the setup prompt does:

  • command: /Applications/Woven.app/Contents/Resources/woven-sidecar
  • argument: --mcp-stdio

Tools

The tools come from the Woven app, so they change when Woven updates. This list is from Woven 0.2.23.

AreaTools
Workspaces and fileslist_workspaces (start here), create_workspace, list_files, read_text_file, import_media, download_file, download_video
Footage and audiolook_at_media, transcribe_media, extract_audio, identify_song
Reelslist_reels, read_reel, write_reel_spec, render_frame, export_reel, open_in_woven, read_woven_guide, list_sfx_library
Captionsgenerate_captions, edit_caption_words
Generationlist_media_models, generate_image, generate_video, generate_audio, get_generation_status, cancel_generation

Every tool except the guide reader needs a signed-in Woven account with a plan or the free trial.

Five tools spend Woven credits: the three generators, captions and transcription. The generation and transcription tools tell your AI app to get your go-ahead before the first paid use.

How the launcher works

bin/woven-mcp is a short shell script:

  1. It looks for Woven.app in /Applications, then in ~/Applications.
  2. It runs Woven.app/Contents/Resources/woven-sidecar --mcp-stdio.

It never writes to stdout, because stdout carries the MCP connection. If Woven isn't installed, it prints where to get it to stderr and exits with code 1. The script itself downloads nothing.

Troubleshooting

  • "Woven isn't installed" in your app's MCP log: install Woven into /Applications or ~/Applications, then restart the app.
  • Tools say you need to sign in or start a plan: open Woven, sign in, and start a plan or the trial.
  • No Woven tools after setup: restart the app or start a new session. Apps load new MCP servers when they start.
  • An older Woven: update it from the menu bar with Woven → Check for Updates….

Links

License

The MIT license in LICENSE covers only this launcher and its packaging. The Woven app and its connector are proprietary and covered by Woven's terms.

Source: README.md at commit b7f354d

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestOct 20, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts