How to Use the HeyGen MCP in Claude

Q: How do I connect HeyGen to Claude Desktop?

Edit your claudedesktopconfig.json file to add the HeyGen MCP server command. Restart the app completely. You can also paste the remote URL directly into Claude Web under Settings.

Q: Can Claude Desktop and HeyGen generate videos from a script?

Yes. Claude writes the script and passes it into generatefromtemplate. It maps your text to the template variables automatically.

Q: Why is my HeyGen video taking so long in Claude Desktop?

Studio rendering takes time. Claude uses getvideostatus to poll the HeyGen API. Just ask your agent to check if the URL is ready.

Generate HeyGen videos directly from Claude Desktop.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HeyGen MCP to Claude Desktop

Create your Vinkius account to connect HeyGen to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup HeyGen with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Render templates instantly with Claude Desktop

You need a video fast, and you don't want to mess with timelines. Your agent runs `list_templates` to grab what's available. It pulls the exact structure using `get_template_details` so you know exactly which text variables to swap out. Once you provide the script, Claude fires off `generate_from_template`. You just wait for `get_video_status` to return completed. It hands you the final video URL right in your chat window.

Build custom scenes from scratch

Sometimes a rigid layout won't cut it. You can ask Claude to check your account limits with `get_api_profile` before doing heavy rendering. Then, it pulls your available actors using `list_avatars` or sorts them by category via `list_avatar_groups`. You define the exact scenes, dialogue, and positioning. The MCP Server processes this payload through `generate_video`. You get a completely custom studio output without touching the HeyGen web interface.

Translate existing videos

Taking an English campaign to a Spanish market usually takes days of editing. Now you just drop the video ID into Claude. The agent triggers `translate_video` with your target language settings. It maintains the original voice and handles the lip-sync automatically. You can monitor the progress by asking Claude to check your recent renders via `list_videos`.

Setup guide

Set up HeyGen MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The HeyGen MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the HeyGen MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under heygen-mcp.

json

{
  "mcpServers": {
    "heygen-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by HeyGen. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect HeyGen now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about HeyGen MCP in Claude Desktop

Edit your `claude_desktop_config.json` file to add the HeyGen MCP server command. Restart the app completely. You can also paste the remote URL directly into Claude Web under Settings.

Yes. Claude writes the script and passes it into `generate_from_template`. It maps your text to the template variables automatically.

Every render deducts from your HeyGen balance. You can ask Claude to run `get_api_profile` to check your remaining quota before starting a big job.

Studio rendering takes time. Claude uses `get_video_status` to poll the HeyGen API. Just ask your agent to check if the URL is ready.

The MCP architecture only transmits the specific text scripts and avatar IDs you provide. Claude never reads your entire video library unless you explicitly call `list_videos`. Your Vinkius endpoint token keeps the connection isolated.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript