Heygen MCP

How to Install and Use Heygen MCP

If you want to use Heygen MCP, a server that helps generate avatars and videos with HeyGen API, here is a simple guide to get you started. Follow these steps carefully to install the software, set it up, and start using it with an example configuration.

Prerequisites: What You Need First

Before installing Heygen MCP, you must make sure you have Python 3.10 or higher installed on your computer. Also, you will need a Heygen API key, which you can get by signing up on the Heygen website. The API key lets you use the HeyGen service, and you start with 10 free credits every month.

Installing uv: The Recommended Package Manager

Heygen MCP recommends using a fast Python package installer called uv. Uv helps make installing and running Heygen MCP smooth and easy. Here’s how to install uv depending on your computer:

• For macOS or Linux:

Open your terminal and run this command to install uv with the official installer script:

curl -LsSf https://astral.sh/uv/install.sh | sh

Alternatively, if you have Homebrew installed on Mac, run:

brew install uv

• For Windows:

Open PowerShell and run:

irm https://astral.sh/uv/install.ps1 | iex

Or, if you use Scoop, run:

scoop install uv

For more ways to install uv, you can check the official uv documentation.

Setting Up Heygen MCP with Claude Desktop

Once you have uv installed, you can set up Heygen MCP to work with Claude Desktop, which is an MCP client. Here is the quick way to connect them:

1. Get your API key from Heygen at heygen.com.
2. Install uv by following the steps above.
3. Open Claude Desktop, go to Settings > Developer > Edit Config and open the claude_desktop_config.json file.
4. Add the following code with your API key inserted where marked:

{
  "mcpServers": {
    "HeyGen": {
      "command": "uvx",
      "args": ["heygen-mcp"],
      "env": {
        "HEYGEN_API_KEY": "<insert-your-api-key-here>"
      }
    }
  }
}

If you are using Windows, remember to enable Developer Mode in Claude Desktop. You can do this by clicking "Help" in the top-left menu and selecting "Enable Developer Mode."

What Heygen MCP Can Do: Available Tools

Heygen MCP offers several useful tools to work with Heygen’s API inside Claude or any MCP client:

• get_remaining_credits: See how many credits you have left.
• get_voices: Get a list of available voices (up to 100).
• get_avatar_groups: List all Heygen avatar groups.
• get_avatars_in_avatar_group: See avatars of a specific group.
• generate_avatar_video: Create a new avatar video using your chosen avatar, text, and voice.
• get_avatar_video_status: Check the status of a video you generated.

Running Locally with MCP Inspector for Testing

If you want to test or develop using Heygen MCP on your local computer, you can use the MCP Inspector tool. Run this command in your terminal to start the server in development mode:

uv --with "mcp[cli]" dev heygen_mcp/server.py

This helps you debug and check how Heygen MCP works before using it more widely.

---

By following these clear steps, you will have Heygen MCP up and running, ready to generate avatars and videos with ease. Just get your API key, install uv, configure Claude Desktop, and start enjoying the fun capabilities of Heygen MCP!