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

# Cursor

> Add HeyGen to Cursor via the marketplace or a custom MCP server. Generate AI avatar videos from natural-language prompts without leaving your editor.

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

<Steps>
  <Step title="Open the HeyGen listing">
    Go to [cursor.com/marketplace/heygen](https://cursor.com/marketplace/heygen) and sign in to Cursor if prompted.
  </Step>

  <Step title="Add it to Cursor">
    Click **Add**. Cursor opens with the HeyGen MCP server pre-filled — confirm to install it.
  </Step>

  <Step title="Verify">
    Open **Cursor Settings → MCP** (or **Tools & Integrations**) and confirm **HeyGen** is listed with its tools enabled.
  </Step>
</Steps>

## Add Manually (Alternative)

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

```json theme={null}
{
  "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:

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