Docs
Vidova MCP
Connect Cursor, Claude Code, Codex, or Windsurf to the local Vidova desktop editor at http://127.0.0.1:17373/mcp.
Vidova Local MCP is a Streamable HTTP endpoint on the desktop app. Server name is vidova-desktop. URL is http://127.0.0.1:17373/mcp. There is no HTTP auth. Traffic never leaves the machine except when a tool starts a hosted job.
Prerequisites
- Vidova desktop is running.
- Local MCP is enabled. Fresh installs leave it on.
- A project is active. Use
get_active_projectorset_active_project. - The editor window for that project is open. Editor tools fail if it is not.
Project tools (list_projects, get_active_project, create_project, set_active_project) work without the editor. Everything else requires the editor.
One-click install
The app can write the local endpoint into the client config. You can also add it by hand. The MCP server name in client configs is vidova.
| Client | Config | Entry |
|---|---|---|
| Cursor | ~/.cursor/mcp.json | { "mcpServers": { "vidova": { "url": "http://127.0.0.1:17373/mcp" } } } |
| Windsurf | ~/.codeium/windsurf/mcp_config.json | { "mcpServers": { "vidova": { "serverUrl": "http://127.0.0.1:17373/mcp" } } } |
| Claude Code | ~/.claude.json plus claude mcp add --transport http --scope user vidova http://127.0.0.1:17373/mcp | HTTP / streamable-http URL |
| Codex | ~/.codex/config.toml plus codex mcp add vidova --url http://127.0.0.1:17373/mcp | streamable HTTP URL |
Restart the client after install when the app says a restart is required.
Tool map
Eighteen tools are published. Open a page for every field.
| Job | Tool |
|---|---|
| List or switch projects | list_projects, get_active_project, set_active_project, create_project |
| Read the timeline | timeline_get_state |
| Edit clips | timeline_edit |
| Zooms and chroma key | clip_enhance |
| Assets, captions, transcribe | asset |
| Inspect media | inspect_media |
| Import | import_asset |
| Preview | preview |
| Image and speech | generate_asset |
| Sound effects | sfx |
| Components | component |
| Branches | branch_action |
| Undo | project_history |
| Recipes | recipe |
| Poll wait | sleep |
Cursor, camera overlay, layout, and captions are vidovaSettings on timeline_edit updateClip. There is no vidova_set_cursor tool.
FAQ
Can I edit Vidova from Cursor or Claude? Yes. The desktop app must be running. Local MCP must be enabled. The editor must be open. See the install table above.
Does this use hosted quota? Most calls are local. generate_asset image uses the image-generation allowance. Speech and asset transcribe use included quotas. Details: quotas.
How do I set the banana cursor? timeline_edit action updateClip with vidovaSettings.cursorStyle set to banana. Field spec: vidovaSettings.