Heygen MCP Server

Official
by heygen-com

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 uv

Windows:

# Install with the official installer script in PowerShell irm https://astral.sh/uv/install.ps1 | iex # Or via Scoop scoop install uv

For other installation methods, see the uv documentation.

Usage

Quickstart with Claude Desktop

  1. Get your API key from HeyGen.
  2. Install uv package manager (see Installing uv section above).
  3. Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json to 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.py

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

-
security - not tested
-
license - not tested
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables Claude Desktop and Agents to generate AI avatars and videos through the HeyGen API, providing tools to create and manage avatar videos with specified text and voice options.

  1. Installation
    1. Prerequisites
    2. Installing uv
  2. Usage
    1. Quickstart with Claude Desktop
    2. Available MCP Tools
  3. Development
    1. Running with MCP Inspector
  4. Roadmap
    1. Contributing
      1. License

        Related MCP Servers

        • -
          security
          A
          license
          -
          quality
          Use HuggingFace Spaces directly from Claude. Use Open Source Image Generation, Chat, Vision tasks and more. Supports Image, Audio and text uploads/downloads.
          Last updated -
          2
          188
          241
          TypeScript
          MIT License
          • Apple
        • -
          security
          F
          license
          -
          quality
          Connects Houdini to Claude AI through Model Context Protocol, enabling AI-assisted 3D modeling, scene creation, simulation setup, and rendering through natural language commands.
          Last updated -
          37
          • Apple
          • Linux
        • -
          security
          A
          license
          -
          quality
          Connects Claude Desktop to Hugging Face Spaces with minimal setup, enabling capabilities like image generation, vision tasks, text-to-speech, and chat with AI models.
          Last updated -
          188
          MIT License
          • Apple
        • A
          security
          F
          license
          A
          quality
          A Model Context Protocol server that enables Claude to generate and upscale images through the Letz AI API, allowing users to create images directly within Claude conversations.
          Last updated -
          2
          1
          JavaScript
          • Linux
          • Apple

        View all related MCP servers

        ID: lwsdskee6d