> ## Documentation Index
> Fetch the complete documentation index at: https://heygen-1fa696a7.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Grok

> Connect HeyGen to Grok with a custom MCP connector, and add HyperFrames from Grok's connector directory. Generate AI avatar videos and render programmatic video without leaving the Grok chat.

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.

<Steps>
  <Step title="Open the connector menu">
    In the Grok prompt bar, click **+** → **Add connector**.
  </Step>

  <Step title="Choose Custom">
    In the **New Connector** dialog, select **Custom — Add your own custom connector**.
  </Step>

  <Step title="Enter the HeyGen MCP endpoint">
    Set **Name** to `HeyGen` and **Server URL** to the remote MCP server URL, then click **Add Connector**:

    ```text theme={null}
    https://mcp.heygen.com/mcp/v1/
    ```
  </Step>

  <Step title="Authenticate with OAuth">
    Click **Connect** and sign in to HeyGen to approve access. This one-time OAuth flow links the connector to your account.
  </Step>
</Steps>

For the full set of tools this unlocks — video generation, avatars, voices, translation, lip-sync, and more — see the [MCP overview](/mcp/overview).

## Connect HyperFrames (Official Connector)

[HyperFrames](/hyperframes) is an official connector in Grok's directory, so there's nothing to paste — just search for it.

<Steps>
  <Step title="Open the connector directory">
    Click **+** → **Add connector** to open the **New Connector** dialog.
  </Step>

  <Step title="Search for HyperFrames">
    Type `hyp` in the search box. **HyperFrames by HeyGen** appears under **Productivity** — select it.
  </Step>

  <Step title="Connect">
    Click **Connect** and approve access via OAuth to link HyperFrames to your account.
  </Step>
</Steps>

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](/hyperframes) for what it can produce.

## Usage

Open a new Grok chat and prompt a request. For example:

```text theme={null}
Generate a 30-second product explainer video with HeyGen.
```

```text theme={null}
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

| Constraint       | Detail                                                                           |
| ---------------- | -------------------------------------------------------------------------------- |
| Grok plan        | Custom connectors require a paid Grok plan.                                      |
| HeyGen Free Tier | Limited video generation credits. Upgrade to Creator plan for production use.    |
| OAuth required   | Both connectors authenticate via OAuth against your HeyGen account on first use. |