HeyGen MCP Server - VS Code Extension
HeyGen MCP Server for VS Code, enabling AI assistants like GitHub Copilot to generate videos, manage avatars, templates, and more through the Model Context Protocol.
Features
- Video Generation: Create AI avatar videos with custom text and voices
- Avatar IV Support: Generate photorealistic videos from photos
- Template Management: Work with dynamic templates and variables
- Asset Management: Upload and manage media files (images, videos, audio)
- Folder Organization: Organize your videos and templates
- Avatar & Voice Selection: Access all available avatars and voices
- Seamless Integration: Works with VS Code's language model features and Copilot
Requirements
- VS Code 1.106.0 or later
- uv - The extension uses
uvx to run the MCP server
- macOS/Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh
- Windows:
irm https://astral.sh/uv/install.ps1 | iex
- See uv installation guide for more options
- HeyGen API key - Get one here (10 free credits/month)
Installation
From VS Code Marketplace
Manual Installation
Clone the repository:
git clone https://github.com/sbroenne/heygen-mcp.git
cd heygen-mcp/vscode-extension
Install dependencies:
npm install
Build the extension:
npm run esbuild
Package the extension:
npx vsce package
Install the .vsix file in VS Code (Extensions → Install from VSIX)
Configuration
1. Get Your HeyGen API Key
- Sign up at HeyGen
- Go to your dashboard and create an API key
- Copy the API key
The extension will prompt for your API key on first use. You can also:
- Use Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
- Search for "HeyGen: Configure API Key"
- Enter your API key when prompted
Or manually in settings (File → Preferences → Settings → search for "heygen"):
- heygen-mcp.apiKey: Your HeyGen API key
Usage
Once configured, the HeyGen MCP server will automatically be available to:
- Claude in VS Code
- GitHub Copilot (with MCP support)
- Other AI assistants that support MCP
Ask your AI assistant to:
Generate an avatar video with...
Create a video from a template...
Upload an image to HeyGen...
List my avatars and voices...
The extension provides access to these HeyGen tools:
User
- Get user profile information
- Check remaining credits
Voices
- List available voices for video generation
Avatars
- List all avatars
- Get avatar details
- List avatar groups
- Get avatars in a specific group
Videos
- Generate avatar videos
- Create Avatar IV videos from photos
- Check video processing status
Templates
- List templates
- Get template details with variables
- Generate videos from templates
Assets
- Upload media files (images, videos, audio)
- List assets
- Delete assets
Folders
- List folders
- Create folders
- Rename folders
- Organize with folder hierarchy
Requirements
- VS Code 1.106.0 or later
- Python 3.10+ with
heygen-mcp-sbroenne package installed
- HeyGen API key (free tier available with monthly credits)
Settings
| Setting |
Type |
Default |
Description |
heygen-mcp.apiKey |
string |
- |
Your HeyGen API key (required) |
heygen-mcp.autoStartServer |
boolean |
true |
Automatically start the server on VS Code startup |
Development
Prerequisites
- Node.js 16+ (for building the extension)
- VS Code 1.106.0+
- npm
Setup
cd vscode-extension
npm install
Build
npm run esbuild
Watch Mode
npm run esbuild-watch
Run Extension
Press F5 or go to Run and Debug to launch the extension in a development host.
Debug
Set breakpoints and use VS Code's debugging tools to debug the extension.
Publishing
To publish a new version:
- Update version in
package.json
- Build and package:
npm run vscode:prepublish
npx vsce package
- Publish to VS Code Marketplace:
npx vsce publish
Troubleshooting
"HeyGen MCP server not found" or "uvx command not found"
Make sure uv is installed (see Requirements above). After installing, restart VS Code.
"API key not valid"
- Verify your API key at HeyGen Dashboard
- Use "HeyGen: Configure API Key" command to update it
- The key is saved in VS Code's global settings
Extension not activating
- Reload VS Code window (Ctrl+Shift+P → "Developer: Reload Window")
- Check VS Code output for errors (View → Output → select "HeyGen MCP" from dropdown)
Links
License
MIT - See LICENSE file for details
Support
For issues and feature requests, visit:
https://github.com/sbroenne/heygen-mcp/issues
Contributing
Contributions welcome! See the main repository for contribution guidelines.
