Skip to main content

​
Prerequisites

  • Cursor installed (latest version recommended)
  • A HeyGen account with Video Agent access
HeyGen is listed in the Cursor marketplace, so setup is one click.
1

Open the HeyGen listing

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

Add it to Cursor

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

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

ConstraintDetail
HeyGen Free TierLimited video generation credits. Upgrade to Creator plan for production use.
OAuth requiredThe connector authenticates via OAuth against your HeyGen account on first use.