> ## 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.

# Gemini CLI

> Connect HeyGen to Gemini CLI and make AI avatar videos from your terminal.

Make HeyGen videos from Gemini CLI with a plain-language prompt. Install the CLI first with `npm install -g @google/gemini-cli@latest`.

<Steps>
  <Step title="Add the server">
    Add HeyGen to `~/.gemini/settings.json`, next to any servers you already have. Use `.gemini/settings.json` in a project folder to add it to that project only.

    ```json theme={null}
    {
      "mcpServers": {
        "heygen": {
          "httpUrl": "https://mcp.heygen.com/mcp/v1/"
        }
      }
    }
    ```

    Restart Gemini CLI.
  </Step>

  <Step title="Connect your HeyGen account">
    The first time Gemini uses HeyGen, approve access in your browser. Run `/mcp` to see `heygen` connected.
  </Step>

  <Step title="Ask for a video">
    ```text theme={null}
    Make a 60-second HeyGen explainer about our new API release.
    ```

    Gemini writes the script, picks the avatar, and renders the video. Finished videos also appear in **Projects** in HeyGen.
  </Step>
</Steps>

<Tip>
  For sharper scripts and scene structure, add [HeyGen Skills](/skills/install) to Gemini CLI.
</Tip>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.