heygen-mcp-server

A Model Context Protocol (MCP) server that provides tools for interacting with the HeyGen API, specifically for managing assets and folders.

This MCP server implements the following HeyGen API endpoints:

• upload_asset - Upload media files (images, videos, audio) to HeyGen
• list_assets - Retrieve all assets in your account
• delete_asset - Delete specific assets by ID

• list_folders - List all folders in your account
• create_folder - Create new folders
• update_folder - Rename existing folders
• trash_folder - Move folders to trash
• restore_folder - Restore trashed folders

1. Clone or download this repository
2. Install dependencies:

   npm install

1. Build the project:

   npm run build

You need to set your HeyGen API key as an environment variable:

export HEYGEN_API_KEY="your_api_key_here"

To get your API key:

1. Go to the HeyGen App
2. Click the top left corner to access your Space
3. Select "Space Settings" from the dropdown
4. Navigate to the API tab
5. Copy your API token

Add the server to your MCP settings file (typically claude_desktop_config.json or similar):

{
  "mcpServers": {
    "heygen": {
      "command": "node",
      "args": [
        "/path/to/mcp-servers/heygen/dist/index.js"
      ],
      "env": {
        "HEYGEN_API_KEY": "your_api_key_here"
      }
    }
  }
}

Or using npx (no installation required):

{
  "mcpServers": {
    "heygen": {
      "command": "npx",
      "args": ["heygen-mcp-server"],
      "env": {
        "HEYGEN_API_KEY": "your_api_key_here"
      }
    }
  }
}

Or if installed globally (npm install -g heygen-mcp-server):

{
  "mcpServers": {
    "heygen": {
      "command": "heygen-mcp-server",
      "env