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 Name	Description
`create_video_agent`	Create a video from a text prompt using HeyGen's Video Agent. This is the recommended way to create videos — just describe what you want and the agent handles avatar selection, scripting, and production.
`create_avatar_video`	Create a video from a specific avatar or image with full control over avatar, voice, and script. Use this only when you need explicit control over avatar selection and scripting. For most video creation, use `create_video_agent` instead.
`list_videos`	List videos in the account with pagination and optional filtering.
`get_video`	Get detailed information about a video including status, URLs, and metadata. Supports both generated and translated videos.
`delete_video`	Permanently delete a video. Supports both generated and translated videos.
`text_to_speech`	Synthesize speech audio from text using a specified voice. Returns a URL to the generated audio file along with duration and optional word-level timestamps.
`list_audio_voices`	List voices available for TTS generation with cursor-based pagination. Filter by type (public/private), language, and gender.
`get_user_me`	Get current user info, remaining balance, and billing.
`create_video_translate`	Translate a video into one or more target languages.
`list_video_translate_languages`	List all supported target language codes for video translation.
`get_video_translate_caption`	Get the caption file (SRT or VTT) for a completed video translation.

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.

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.