HeyGen Remote MCP Server

Overview

HeyGen Remote MCP lets AI agents like Claude, Gemini CLI, and Cursor create HeyGen videos on your behalf using your existing HeyGen account. It uses the Model Context Protocol (MCP) over a hosted endpoint, so there's nothing to install or run locally.

You authenticate once with OAuth, and your agent gets access to HeyGen's video tools — using the credits from your current plan.

Endpoint:

https://mcp.heygen.com/mcp/v1/

What You Can Do

Once connected, your AI agent has access to the following tools:

Tool	Description
Generate Video Agent	Create a video from a text prompt using Video Agent V2A
Text-to-Speech	Synthesize speech audio from text using a specified voice
List Audio Voices	Browse available TTS voices with pagination
Get Video	Retrieve video details including status, URLs, and metadata
List Videos	List videos in your account with optional filtering
Delete Video	Permanently delete a video

Claude Web / Claude Desktop

Open Settings → Connectors (or click the MCP integrations icon)
Search for HeyGen and click Connect
Authorize with your HeyGen account via OAuth
HeyGen tools are now available in your conversation

Try it:

"Use HeyGen to create a 30-second product launch video for our new feature."

Claude will write the script, call HeyGen's Video Agent, generate the video, and return the video ID. You can then ask Claude to check the status and retrieve the download URL.

Claude Code

Add the remote MCP server from your terminal:

claude mcp add --transport http heygen https://mcp.heygen.com/mcp/v1/

Authenticate once when prompted. After that, Claude Code can:

Write and optimize a video script
Call HeyGen's Video Agent to generate the video
Poll the status until rendering completes
Return the final video URL

No API tokens or separate billing required — it uses your existing HeyGen account.

Gemini CLI

Add HeyGen as an MCP server in your Gemini CLI configuration:

{
  "mcpServers": {
    "heygen": {
      "url": "https://mcp.heygen.com/mcp/v1/"
    }
  }
}

Cursor

Add HeyGen to your Cursor MCP configuration (.cursor/mcp.json):

{
  "mcpServers": {
    "heygen": {
      "url": "https://mcp.heygen.com/mcp/v1/"
    }
  }
}

Example use case: While coding in Cursor, ask your agent to create a product demo video from your release notes — it reads your docs, writes the script, generates the video, and returns the link, all without leaving your editor.

Any MCP-Compatible Agent

Any tool that supports MCP can connect to HeyGen using the remote endpoint:

https://mcp.heygen.com/mcp/v1/

Authenticate via OAuth when prompted. No API key management needed.

How It Works

Connect — Add the HeyGen remote MCP endpoint to your agent
Authenticate — Sign in with your HeyGen account via OAuth (one-time)
Use — Your agent calls HeyGen tools directly in conversation or code

All video generation uses your existing HeyGen plan and credits. There are no separate API charges or additional billing.

Remote MCP

	Remote MCP
Setup	Add endpoint URL, authenticate via OAuth
Runs on	HeyGen's hosted infrastructure
Authentication	OAuth (no API key needed)
Billing	Web plan + premium credits
Best for	Most users — quick setup, works everywhere

FAQ

Do I need an API key? No. Remote MCP uses OAuth authentication tied to your HeyGen account. No API key required.

Does this cost extra? No. Video generation uses the credits included in your existing HeyGen plan.

Which HeyGen plans support this? Remote MCP is available on all HeyGen plans.

Can I use my custom avatars and voices? Yes. Any avatars and voices available in your HeyGen account are accessible through Remote MCP.

What's the difference between this and the HeyGen API? The HeyGen API gives you direct REST endpoints for programmatic control. Remote MCP wraps those capabilities so AI agents can use them conversationally — without you writing integration code.