Skip to main content
Grok supports two HeyGen connectors. Add HeyGen as a custom connector to generate avatar videos, and add HyperFrames by HeyGen — an official, listed connector — to render programmatic HTML video. Both authenticate with OAuth and draw on your existing HeyGen plan’s credits — no API key required.

​
Prerequisites

  • A Grok account with connector support (custom connectors require a paid Grok plan)
  • A HeyGen account (Creator plan or above recommended for full video generation access)

​
Connect HeyGen (Custom Connector)

HeyGen isn’t listed in Grok’s connector directory yet, so add it as a custom connector with the remote MCP server URL.
1

Open the connector menu

In the Grok prompt bar, click + → Add connector.
2

Choose Custom

In the New Connector dialog, select Custom — Add your own custom connector.
3

Enter the HeyGen MCP endpoint

Set Name to HeyGen and Server URL to the remote MCP server URL, then click Add Connector:
https://mcp.heygen.com/mcp/v1/
4

Authenticate with OAuth

Click Connect and sign in to HeyGen to approve access. This one-time OAuth flow links the connector to your account.
For the full set of tools this unlocks — video generation, avatars, voices, translation, lip-sync, and more — see the MCP overview.

​
Connect HyperFrames (Official Connector)

HyperFrames is an official connector in Grok’s directory, so there’s nothing to paste — just search for it.
1

Open the connector directory

Click + → Add connector to open the New Connector dialog.
2

Search for HyperFrames

Type hyp in the search box. HyperFrames by HeyGen appears under Productivity — select it.
3

Connect

Click Connect and approve access via OAuth to link HyperFrames to your account.
Once connected, ask Grok to build and render a programmatic video project — HyperFrames turns a self-contained HTML composition into an MP4, WebM, or MOV, ideal for motion graphics and data-driven visuals. See the HyperFrames guide for what it can produce.

​
Usage

Open a new Grok chat and prompt a request. For example: 
Generate a 30-second product explainer video with HeyGen.

Use HyperFrames to render a data-driven motion graphic of our Q2 revenue.
Grok calls the connector’s tools to handle scripting, avatar selection, rendering, and more. Completed HeyGen videos are also accessible from the Projects page in your HeyGen dashboard.

​
Limitations

ConstraintDetail
Grok planCustom connectors require a paid Grok plan.
HeyGen Free TierLimited video generation credits. Upgrade to Creator plan for production use.
OAuth requiredBoth connectors authenticate via OAuth against your HeyGen account on first use.