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

**1. 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.

**2. Connect your HeyGen account**

The first time Gemini uses HeyGen, approve access in your browser. Run `/mcp` to see `heygen` connected.

**3. 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.

> [!TIP]
>
> For sharper scripts and scene structure, add [HeyGen Skills](https://heygen-1fa696a7.mintlify.site/skills/install.md) to Gemini CLI.


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