Heygen MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Heygen MCP Server generate a video with avatar Mark saying hello in a friendly tone"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Heygen MCP Server

The HeyGen MCP server enables any MCP Client like Claude Desktop or Agents to use the HeyGen API to generate avatars and videos.
Note: This project is in early development. While we welcome community feedback and contributions, please be aware that official support is limited.
Installation
Prerequisites
Python 3.10 or higher
A Heygen API key (get one from Heygen). Includes 10 Free Credits per Month
Installing uv
uv is a fast Python package installer and resolver that we recommend for installing this package.
macOS or Linux:
# Install with the official installer script
curl -LsSf https://astral.sh/uv/install.sh | sh
# Or via Homebrew (macOS)
brew install uvWindows:
# Install with the official installer script in PowerShell
irm https://astral.sh/uv/install.ps1 | iex
# Or via Scoop
scoop install uvFor other installation methods, see the uv documentation.
Related MCP server: heygen-mcp
Usage
Quickstart with Claude Desktop
Get your API key from HeyGen.
Install uv package manager (see Installing uv section above).
Go to Claude > Settings > Developer > Edit Config >
claude_desktop_config.jsonto include the following:
{
"mcpServers": {
"HeyGen": {
"command": "uvx",
"args": ["heygen-mcp"],
"env": {
"HEYGEN_API_KEY": "<insert-your-api-key-here>"
}
}
}
}If you're using Windows, you'll need to enable "Developer Mode" in Claude Desktop to use the MCP server. Click "Help" in the hamburger menu at the top left and select "Enable Developer Mode".
Available MCP Tools
The server provides the following tools to Claude:
get_remaining_credits: Retrieves the remaining credits in your Heygen account.
get_voices: Retrieves a list of available voices from the Heygen API (limited to first 100 voices).
get_avatar_groups: Retrieves a list of Heygen avatar groups.
get_avatars_in_avatar_group: Retrieves a list of avatars in a specific Heygen avatar group.
generate_avatar_video: Generates a new avatar video with the specified avatar, text, and voice.
get_avatar_video_status: Retrieves the status of a video generated via the Heygen API.
Development
Running with MCP Inspector
To run the server locally with the MCP Inspector for testing and debugging:
uv --with "mcp[cli]" dev heygen_mcp/server.pyThis will start the server in development mode and allow you to use the MCP Inspector to test the available tools and functionality.
Roadmap
Tests
CICD
Photo Avatar APIs Support
SSE And Remote MCP Server with OAuth Flow
Translation API Support
Template API Support
Interactive Avatar API Support
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Available Tools
7 toolsgenerate_avatar_videoC
Generates a new avatar video via the HeyGen API.
Inputs: avatar_id (required), input_text (required), voice_id (required), title.
generate_avatar_video_with_multiple_scenesC
Generates a new avatar video via the HeyGen API. with multiple scenes.
Inputs: title (required), video_inputs (required), dimension.
get_avatar_groupsA
Retrieves a list of HeyGen avatar groups. By default, only private avatar groups are returned, unless include_public is set to true. Avatar groups are collections of avatars, avatar group ids cannot be used to generate videos.
Inputs: include_public.
get_avatars_in_avatar_groupC
Retrieves a list of avatars in a specific HeyGen avatar group.
Inputs: group_id (required).
get_avatar_video_statusA
Retrieves the status of a video generated via the HeyGen API. Video status make take several minutes to hours depending on length of video and queue time. If video is not yet complete, status be viewed later by user via https://app.heygen.com/home
Inputs: video_id (required).
get_remaining_creditsA
Retrieves the remaining credits in heygen account.
Inputs: no named parameters.
get_voicesA
Retrieves a list of available voices from the HeyGen API. Results truncated to first 100 voices. Private voices generally will returned 1st.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
The two generate_avatar_video tools have overlapping descriptions and could confuse agents about which to use for single vs. multi-scene videos. Other tools are well-distinguished.
All tool names follow a consistent verb_noun pattern with snake_case: generate_ for creation and get_ for retrieval, making the surface predictable.
With 7 tools covering video generation, status, avatars, voices, and credits, the count is well-scoped for a focused HeyGen integration.
Core workflows like video generation, status checking, and resource listing are covered. Missing are tools to list or manage generated videos, but the surface is largely complete.
Maintenance
Related MCP Connectors
AI voice generation: text-to-speech and voice cloning from any MCP client.
MCP server for Google Veo AI video generation
MCP server for Hailuo (MiniMax) AI video generation
MCP server for Kling AI video generation
Related MCP Servers
- AlicenseNot gradedqualityDmaintenance🎬 Enterprise-grade MCP Server for Creatify AI - 12 tools for AI video generation: avatar videos, URL-to-video, AI shorts, custom avatars, script generation, advanced lip-sync with emotion control. Complete API coverage with semantic versioning.21 npm23MIT
- FlicenseNot gradedqualityDmaintenanceExposes HeyGen's video generation API to MCP-compatible clients, enabling listing avatars, generating videos, and checking render status.-
- FlicenseAqualityDmaintenanceMCP server for the HeyGen avatar video API. Provides tools to generate talking-avatar videos, including video creation, status checking, downloading, and listing avatars/voices.8-
- AlicenseNot gradedqualityAmaintenanceThis server enables MCP-compatible clients to generate images, videos, and speech, clone or design voices, and use configurable transports.635 npmMIT