How to Use the HeyGen MCP in Claude

Q: How do I install the HeyGen MCP Server in Claude Desktop?

Edit your claudedesktopconfig.json file. Add the MCP server command and your API credentials, then restart the application.

Generate and manage HeyGen avatar 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

Video Generation in Claude Desktop

The `generate_from_prompt` and `generate_ai_video` tools let Claude Desktop turn your text into finished MP4s. You paste a script into the chat. Your agent reads the text, picks a default avatar, and fires off the rendering job in the background. You don't have to leave the window. The MCP Server handles the heavy lifting while you keep working on other tasks.

Discover Actors and Voices

Running `list_available_avatars` and `list_available_voices` pulls the exact actor IDs you need. Ask your client to show you the British English voices. It queries the directory and returns a formatted list of options. This skips the manual step of hunting through a web dashboard for asset names. You get the exact string required to build your API request.

Track Rendering Status

Polling `get_video_progress` checks the status of your current render queue. Video generation takes time. Instead of guessing when it finishes, you ask your agent for an update. Once the file is ready, you can fetch the URL or use `remove_video_record` to clean up old files. You manage your entire media library through conversation.

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-alternative-mcp.

json

{
  "mcpServers": {
    "heygen-alternative-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. Add the MCP server command and your API credentials, then restart the application.

Yes. Claude reads the script file from your hard drive and sends the text directly to the generation endpoint.

Ask your client to check the status. It calls the progress endpoint and tells you if the file is queued, processing, or completed.

You need a valid API key with rendering credits. The MCP setup just acts as a bridge to your existing account.

Your text prompts and image files pass straight from your machine to the rendering API. The MCP architecture keeps everything localized, meaning no third-party database intercepts your content before it reaches the destination.

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