Connect Claude to Valmera for video editing
Add Valmera as a custom connector and Claude can edit footage you upload. It reads the transcript and frames, cuts silences and filler words, adds word-timed captions, reframes to 9:16, adds music and b-roll, renders a preview it checks itself, and exports the full-quality MP4. Setup takes about a minute in claude.ai, Claude Desktop or Claude Code.
CONNECTOR URL
https://valmera.io/mcp/serverOr use the connect page: it walks you through the steps and shows when Valmera receives Claude's first request.
Connect Valmera in claude.ai or Claude Desktop
- 1Open the connector settingsGo to Customize → Connectors, click + Add, then choose Add custom connector.
- 2Paste the URLName it Valmera, paste https://valmera.io/mcp/server and click Continue.
- 3Keep the detected sign-inClaude detects Valmera's OAuth sign-in. If it asks how it should identify itself, choose Register automatically: Valmera uses dynamic client registration, so there is no client ID or secret to create. Click Add.
- 4Sign in and allowClick Connect, sign in to Valmera with the email or Google account you subscribed with, and choose Allow connection.
- 5Turn it on in a chatOpen the + menu → Connectors and switch Valmera on. Then ask: List my Valmera projects. An empty list still means the connection works.
On Team and Enterprise plans an Owner adds the connector in Organization settings → Connectors first; members then click Connect under Customize → Connectors.
Connect Claude Code
One command, then authenticate from the /mcp panel:
claude mcp add --transport http valmera https://valmera.io/mcp/server
# then, inside Claude Code:
/mcpFor a headless run, pass a private token instead: add --header "Authorization: Bearer $VALMERA_MCP_TOKEN" with a token from the connect page. The Claude Code guide covers scopes, a shared .mcp.json and a full session from local file to MP4.
Get your footage into Valmera
| Where you are | How the video gets in |
|---|---|
| claude.ai or Claude Desktop | Upload in Valmera Studio, then ask Claude to open that project. Claude can't read files on your disk. |
| Claude Code | Point it at a local file. It calls upload_start, PUTs the bytes to the presigned URL with curl, then calls upload_finish. |
| Any client | fetch_url imports clips, music and images from a link you paste. |
Main videos can be MP4, MOV, M4V, MKV or WebM, up to 100 GB and 3 hours. Valmera indexes each upload once (word-level transcript with speaker labels, shots, silences and on-screen text) and every edit reuses it. See file uploads.
Your first edit
Describe the result you want. Claude chooses the tools and their order: timings from the transcript, captions after cuts, music fitted to the final length.
List my Valmera projects and their IDs.
Open my latest project. Cut the dead air and the ums but keep natural pauses, add bold word-by-word captions, reframe to 9:16, render a preview and tell me what you changed.
Watch the preview yourself and fix anything that looks or sounds wrong before I review it.
Export the version I just approved as a full-quality MP4 and give me the download link.
More in the prompt library. For a recorded example with the original file, the exact cuts and the export, see the trim-and-reframe example.
Review and export
Claude renders a preview with render_preview, looks at the frames it produced with look_at or watch_video, and fixes what it finds before it replies. Revise in plain English ("looser cuts", "bigger captions", "put the intro back"); every change is a new version of the edit, so nothing is lost.
When it's right, ask for the final video. Claude calls export_final for the version you approved, follows the job with wait_for_job, and returns a link from download_url. The MP4 is rendered at full resolution from your original file and ends with a brief Valmera end card. Studio's Export button works too.
Troubleshooting
- There is no Add custom connector option
- Team and Enterprise members can't add connectors themselves: an Owner adds Valmera in Organization settings → Connectors, then members open Customize → Connectors and click Connect.
- Sign-in fails or loops
- Remove the connector and add it again. When Claude asks how to identify itself, choose Register automatically. Valmera uses dynamic client registration.
- “Connecting apps to Valmera is not enabled for this account”
- Sign in with the Valmera account that has your subscription. MCP access is included with eligible subscriptions; see plans at /subscribe.
- New tools are missing after an update
- Disconnect and reconnect Valmera under Customize → Connectors, then start a new chat so Claude reloads the tool list.
- A render says STILL RUNNING
- That is normal. Slow work returns a job ID and Claude calls wait_for_job until it finishes. Ask it to keep waiting rather than start the render again.
- Editing is refused because the project is busy
- The same project is being edited in Studio. Editing one project from Studio and over MCP at once is refused in both directions; let the other edit finish.
- The URL shows an error in a browser tab
- It is an MCP endpoint, not a web page. Paste it into Claude's connector settings.
Claude reaches custom connectors from Anthropic's cloud, not from your computer, so the server must be public. Valmera's is. Anthropic's custom connector guide has the current menus (checked October 6, 2026).
Limits
- Valmera edits footage you provide; it doesn't generate video from a prompt.
- Captions are burned in, with no SRT or VTT file. No direct publishing to YouTube or TikTok.
- Over MCP, Claude edits with the tools directly; it can't hand the job to Valmera's in-house agent.
- One editor per project at a time: Studio and Claude can't edit the same project at once.
The full list is on the MCP server page.
Frequently Asked Questions
Made with Valmera: real exports
Connect Claude to Valmera
Creating an account and uploading are free. Editing requires a subscription; MCP access is included with eligible plans.
Connect your assistant →