Skip to main content
Using ChatGPT or Codex? Install the HeyGen plugin instead of adding the endpoint by hand. It connects your HeyGen account and includes HeyGen’s video skills.

ChatGPT

Install the HeyGen plugin from the ChatGPT plugin directory.

Codex

Install the plugin in the Codex app, or add the MCP server in Codex CLI.

Add HeyGen to Your Agent

1

Open your agent's connector settings

In your MCP-compatible agent (Claude, Cursor, Gemini CLI, Manus, and others), open the Connectors or MCP servers settings and choose Add custom connector.
2

Paste the HeyGen MCP endpoint

Name the connector HeyGen and enter the remote MCP server URL:
3

Authenticate with OAuth

Click Connect and sign in to HeyGen to approve access. This one-time OAuth flow links the connector to your account — no API key required.
4

Start creating

Ask your agent to generate a video — for example, “Make a 30-second product explainer with HeyGen.” It calls HeyGen’s tools directly and bills against your existing plan.
Menu names vary slightly by agent. For click-by-click instructions, see the per-product setup guides below.
HeyGen Video duration through MCP: text_to_video, image_to_video and reference_to_video accept 5–30 seconds on all plans with turbo or quality enhancement. duration: "auto" selects 8–15 seconds, so set an explicit duration for a 16–30 second clip. See Duration limits. This limit applies to HeyGen Video, not the separate Video Agent or avatar video tools.

What You Can Do

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

Video Agent

Videos

Templates

Audio

Video Translate

AI Clipping

Batches

Video Translation Batches

Lipsync Batches

Asset Batches

User

Avatars

Assets

Folders

Lipsync

Brand

Models

Filler Word Removal

Supported Products

HeyGen Remote MCP works with MCP-compatible agents, including:
  • ChatGPT (install the HeyGen plugin)
  • Claude (Web, Desktop, and Code)
  • Codex (the HeyGen plugin in the app, the MCP server in the CLI; see Codex)
  • Cursor (available in the Cursor marketplace)
  • Gemini CLI
  • Lovable
  • Manus
  • Superhuman
  • and more
See the dedicated setup guide for each product for detailed instructions.

Connect Your Own Agent

Remote MCP connects an AI agent you use to your own HeyGen account. If your agent supports custom MCP servers, add this endpoint and sign in with your HeyGen account:

Building an App or Platform? Use the API

Remote MCP sign-in works only from the supported agents above, for your own HeyGen account. Apps where your users connect their HeyGen accounts, MCP gateways, and automation tools such as Make and n8n can’t sign in; they get Invalid redirect_uri: not registered for this client. Use the HeyGen API with an API key instead.

Remote MCP

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. Why do I get Invalid redirect_uri: not registered for this client? Remote MCP sign-in is for your own AI agent. If you’re connecting from an app, gateway, or automation tool, use the HeyGen API with an API key. See Building an App or Platform? 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.