# 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

1. Vidova desktop is running.
2. Local MCP is enabled. Fresh installs leave it on.
3. A project is active. Use `get_active_project` or `set_active_project`.
4. 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](/docs/mcp/tools/list_projects), [get_active_project](/docs/mcp/tools/get_active_project), [set_active_project](/docs/mcp/tools/set_active_project), [create_project](/docs/mcp/tools/create_project) |
| Read the timeline | [timeline_get_state](/docs/mcp/tools/timeline_get_state) |
| Edit clips | [timeline_edit](/docs/mcp/tools/timeline_edit) |
| Zooms and chroma key | [clip_enhance](/docs/mcp/tools/clip_enhance) |
| Assets, captions, transcribe | [asset](/docs/mcp/tools/asset) |
| Inspect media | [inspect_media](/docs/mcp/tools/inspect_media) |
| Import | [import_asset](/docs/mcp/tools/import_asset) |
| Preview | [preview](/docs/mcp/tools/preview) |
| Image and speech | [generate_asset](/docs/mcp/tools/generate_asset) |
| Sound effects | [sfx](/docs/mcp/tools/sfx) |
| Components | [component](/docs/mcp/tools/component) |
| Branches | [branch_action](/docs/mcp/tools/branch_action) |
| Undo | [project_history](/docs/mcp/tools/project_history) |
| Recipes | [recipe](/docs/mcp/tools/recipe) |
| Poll wait | [sleep](/docs/mcp/tools/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](/docs/mcp/tools/generate_asset) image uses the image-generation allowance. Speech and `asset` transcribe use included quotas. Details: [quotas](/docs/mcp/quotas).

**How do I set the banana cursor?** `timeline_edit` action `updateClip` with `vidovaSettings.cursorStyle` set to `banana`. Field spec: [vidovaSettings](/docs/mcp/schemas/vidova-settings).