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
/Applicationsor~/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:
- checks that it is running on a Mac;
- installs Woven with Homebrew, only if you agree;
- adds Woven's connector to the app;
- 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.
-
Install Woven. Either download it and move it to Applications, or run:
brew install --cask woven-video/tap/woven -
Open Woven once and sign in.
-
Add the connector to your AI app.
Claude Code
claude mcp add --scope user woven -- npx -y @woven-video/mcp
Codex
codex mcp add woven -- npx -y @woven-video/mcp
Other apps that take a JSON MCP config, such as Cursor:
{
"mcpServers": {
"woven": {
"command": "npx",
"args": ["-y", "@woven-video/mcp"]
}
}
}
- Restart the app, or start a new session, so it loads the Woven tools.
- 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.
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:
- It looks for
Woven.appin/Applications, then in~/Applications. - 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
/Applicationsor~/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
- Woven product guide
- What is a video editing MCP server?
- Privacy · Terms · Contact
- MCP Registry name:
io.github.woven-video/woven
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.
