Cursor - HeyGen Documentation

Prerequisites

Cursor installed (latest version recommended)
A HeyGen account with Video Agent access

Install from the Cursor Marketplace (Recommended)

HeyGen is listed in the Cursor marketplace, so setup is one click.

Open the HeyGen listing

Go to cursor.com/marketplace/heygen and sign in to Cursor if prompted.

Add it to Cursor

Click Add. Cursor opens with the HeyGen MCP server pre-filled — confirm to install it.

Verify

Open Cursor Settings → MCP (or Tools & Integrations) and confirm HeyGen is listed with its tools enabled.

Add Manually (Alternative)

To configure it yourself, add HeyGen under Cursor Settings → MCP → Add new MCP server, or edit ~/.cursor/mcp.json directly:

{
  "mcpServers": {
    "heygen": {
      "url": "https://mcp.heygen.com/mcp/v1/"
    }
  }
}

If you already have other MCP servers configured, add heygen alongside them inside the existing mcpServers block.

Authentication

On first tool use, Cursor opens a browser-based OAuth flow. Sign in to HeyGen and approve access to link the connector to your account — no API key required.

Usage

In Cursor’s chat (Agent mode), prompt a video generation request:

Generate a 60-second explainer video about our new API release using HeyGen.

Cursor calls HeyGen’s tools to handle scripting, avatar selection, and rendering. Completed videos are also accessible from the Projects page in your HeyGen dashboard.

Limitations

Constraint	Detail
HeyGen Free Tier	Limited video generation credits. Upgrade to Creator plan for production use.
OAuth required	The connector authenticates via OAuth against your HeyGen account on first use.

Gemini CLIWire HeyGen into Gemini CLI via MCP. Generate AI avatar videos from natural-language prompts in your terminal as part of any development or content workflow.

⌘I

​Prerequisites

​Install from the Cursor Marketplace (Recommended)

​Add Manually (Alternative)

​Authentication

​Usage

​Limitations