Skip to main content
HeyGen Remote MCP lets AI agents like Manus, 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 NameDescription
create_video_agentCreate 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_videoCreate 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_videosList videos in the account with pagination and optional filtering.
get_videoGet detailed information about a video including status, URLs, and metadata. Supports both generated and translated videos.
delete_videoPermanently delete a video. Supports both generated and translated videos.
text_to_speechSynthesize 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_voicesList voices available for TTS generation with cursor-based pagination. Filter by type (public/private), language, and gender.
get_user_meGet current user info, remaining balance, and billing.
create_video_translateTranslate a video into one or more target languages.
list_video_translate_languagesList all supported target language codes for video translation.
get_video_translate_captionGet the caption file (SRT or VTT) for a completed video translation.

​
Supported Products

HeyGen Remote MCP works with any MCP-compatible agent, including:
  • Claude (Web, Desktop, and Code)
  • Gemini CLI
  • Cursor
  • Manus
  • Superhuman
  • OpenAI
  • and more
See the dedicated setup guide for each product for detailed instructions.

​
Connect Your Own Agent

You can integrate HeyGen Remote MCP into any custom agent or application that supports the Model Context Protocol. Just point it to the endpoint: 
https://mcp.heygen.com/mcp/v1/
For security, HeyGen Remote MCP uses domain whitelisting. If your agent runs on a domain that isn’t already whitelisted, you’ll need to request access before it can connect. To request domain whitelisting, submit your domain here: [link]

​
How It Works

  1. Connect — Add the HeyGen remote MCP endpoint to your agent
  2. Authenticate — Sign in with your HeyGen account via OAuth (one-time)
  3. 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
SetupAdd endpoint URL, authenticate via OAuth
Runs onHeyGen’s hosted infrastructure
AuthenticationOAuth (no API key needed)
BillingWeb plan + premium credits
Best forMost 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.