Guide · Claude and MCP

How to add subtitles to a video with Claude

Claude does not edit video files by itself. Connect AwesomeVideo once, paste a link to the video and ask for subtitles: Claude makes one tool call and gives you back the MP4 with styled subtitles burned in, plus SRT and VTT files. No sign-up, about $0.05 per minute. Works in the Claude app and in Claude Code.

Two ways in

WhereConnect withAPI key
Claude app (web, Desktop, Cowork)Custom connector: https://api.awesomevideoeditor.com/mcp/oauthNone to paste. Click Allow once; the connection gets its own key.
Claude Codeclaude mcp add --transport http (one command)None to connect: Claude creates one with the free create_key tool. Or pass your key in a header.

In the Claude app, step by step

  1. 1. Add AwesomeVideo as a custom connector

    In Claude, open Customize > Connectors, click + Add, then Add custom connector. Name it AwesomeVideo, paste the server URL and click Continue. Keep the sign-in Claude detects (OAuth) and Use Claude's published identity, then click Add. Free plans can add one custom connector; on Team and Enterprise an owner adds it first.

    https://api.awesomevideoeditor.com/mcp/oauth
  2. 2. Connect and click Allow

    Click Connect. AwesomeVideo opens a page with one button: Allow. It takes one click, with no sign-up, and the connection gets its own key with free trial credits when available. To spend an account balance instead, sign in with an email link on the same page. Then, in a chat, open + > Connectors and turn AwesomeVideo on.

  3. 3. Give Claude a link to the video and ask for subtitles

    Paste a public link to the video: a direct MP4 or MOV URL, or a Google Drive, Dropbox or OneDrive share link (up to 80 MB). YouTube, TikTok and Instagram page links are refused and nothing is charged. Ask in plain words and name a style if you want one.

    Add subtitles to this video in the karaoke style: https://example.com/interview.mp4
  4. 4. Download the MP4 and the subtitle files

    Claude calls caption_video once: it transcribes the speech, burns styled subtitles into the frames and returns the MP4 link plus SRT, VTT and a JSON transcript. Short clips come back in the same call (it waits up to 45 seconds by default); longer ones return a job id that Claude checks with get_job. 5 credits per minute (about $0.05); the 8-second sample costs 2. Links expire after 24 hours, so download the files right away.

In Claude Code

One command, no key needed to connect. Claude creates one with the free create_key tool when it first needs it.

claude mcp add --transport http awesomevideo https://api.awesomevideoeditor.com/mcp

Already have a key (from /account or POST /v1/keys/anonymous)? Send it in a header:

claude mcp add --transport http awesomevideo https://api.awesomevideoeditor.com/mcp \
  --header "Authorization: Bearer $AV_KEY"

Check the connection:

claude mcp list
# awesomevideo: https://api.awesomevideoeditor.com/mcp (HTTP) - ✔ Connected

Claude Code can also caption a file on your disk: it asks upload (action start) for a one-time upload URL and sends the file with curl.

What to ask

Plain words are enough. The tool Claude should pick:

“Add subtitles to this video: https://example.com/interview.mp4”
caption_video
“Use the karaoke style and keep the captions clear of the TikTok buttons.”
caption_video with preset karaoke, platform tiktok
“Show me three caption styles on my video before you render it.”
preview (mode sample, free)
“Here is my SRT file. Burn it into this video as is.”
burn_captions (subtitles = the file's text)
“Make Spanish subtitles for this English video and burn them in.”
caption_video with translateTo: es
“How much would a 3-minute video cost?”
estimate (free)

What Claude gets back

The real tool result for the 8-second CC0 sample, trimmed (run on November 19, 2026).

tools/call  caption_video
{ "sourceUrl": "https://awesomevideoeditor.com/samples/cc0-interview-es.mp4", "preset": "pop-words" }
(answered after 25 s)
{
  "id": "540f3828-...",
  "kind": "caption",
  "status": "succeeded",
  "audioSeconds": 8,
  "creditsCharged": 2,
  "result": {
    "url": "https://api.awesomevideoeditor.com/v1/jobs/540f3828-.../result?...",
    "language": "es",
    "preset": { "id": "builtin:pop-words", "name": "Pop Words" },
    "files": [
      { "name": "mp4", "contentType": "video/mp4", "url": "..." },
      { "name": "srt", "text": "1\n00:00:00,000 --> 00:00:02,380\nen la escuela es súper diferente al mundo\n...", "url": "..." },
      { "name": "vtt", "text": "WEBVTT\n\n00:00:00.000 --> 00:00:02.380\n...", "url": "..." },
      { "name": "json", "url": "..." }
    ]
  },
  "next": "Done. result.files has mp4, srt, vtt, and json links (valid until expiresAt). Send the mp4 link to the user."
}

Same call over plain HTTP: add subtitles with an API. Caption looks with real renders: styles.

Questions

Can Claude add subtitles to a video?
Not by itself: Claude does not edit video files. Connect a caption tool over MCP and it can. With the AwesomeVideo connector, Claude sends the video link to caption_video, which transcribes the speech, burns styled subtitles into the frames and returns the MP4 plus SRT and VTT files.
Do I need an AwesomeVideo account or API key?
No. In the Claude app you click Allow once and the connection gets its own key, with free trial credits when available (enough for the 8-second sample). In Claude Code, Claude creates a key with the free create_key tool. Credits are prepaid after that: $5 buys 500. To use an existing balance, sign in with an email link on the Allow page or pass your key in a header.
Which Claude plans can use it?
Custom connectors work on Claude's Free, Pro, Max, Ultra, Team and Enterprise plans, according to Anthropic's Help Center. Free plans can add one custom connector. On Team and Enterprise, an owner adds the connector to the organization first. Claude Code adds it with one command.
Can Claude burn my own SRT file instead of transcribing?
Yes. Give Claude the SRT or VTT file and the video link and ask it to burn the file as is. It calls burn_captions with the file's text in subtitles: your timings and wording are kept and nothing is transcribed. 4 credits (about $0.04) per minute of video.
Can I use a video from my computer?
In the Claude app, share it as a Google Drive, Dropbox or OneDrive link and paste that link. In Claude Code, Claude can upload the local file itself: upload (action start) returns a one-time upload URL and Claude sends the file with curl (up to 2048 MB with the multipart upload).
How much does it cost?
1 credit = 1 US cent, billed per second: 5 credits per minute to transcribe and burn, 4 to burn your own subtitle file, plus 2 per minute to translate. The 8-second sample costs 2 credits. Asking for a price with estimate, or style previews (preview mode sample), is free, and failed jobs are refunded.
Does it work in Claude Code too?
Yes. Run claude mcp add --transport http awesomevideo https://api.awesomevideoeditor.com/mcp, then ask for subtitles in the session. claude mcp list should show ✔ Connected. To sign in instead of using a key, add https://api.awesomevideoeditor.com/mcp/oauth and run /mcp in Claude Code.

More

How we checked: on November 19, 2026, Claude Code 2.1.328 added the server with claude mcp add and claude mcp list reported ✔ Connected; the caption_video call above ran over MCP against the same server code. The Claude app steps follow Anthropic's Help Center; they were not clicked through in claude.ai from our test machine. Sample clip: “Entrevista Maricarmen Canales - TECMTY” by NachoCHOCO, CC0, via Wikimedia Commons.