How to Use the HeyGen MCP in CrewAI

Q: How do CrewAI agents select the right HeyGen voice actor?

Your writer agent calls listavailablevoices to read the active list of voices. It matches the voice characteristics with the script's tone and passes the choice to the generator.

Q: Can a CrewAI manager agent monitor HeyGen video rendering status?

Yes, you assign a manager agent to poll getvideoprogress periodically. This keeps the rest of your CrewAI team free to write scripts or research new topics while the video renders.

Q: Can my crew delete old videos from the library?

Yes, you can give your archivist agent access to removevideorecord. The agent will search your video list and delete outdated files to keep your workspace clean.

Deploy a CrewAI team where researcher, writer, and speaker agents collaborate to produce ready-to-publish HeyGen videos.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HeyGen MCP to CrewAI

Create your Vinkius account to connect HeyGen to CrewAI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup HeyGen with CrewAI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Multi-Agent Crews Using this MCP Server

The `generate_from_prompt` tool lets your CrewAI speaker agent instantly turn scripts written by your writer agent into finished videos. Instead of a human copying and pasting text, the agents handle the handoff autonomously. This MCP Server allows your crew to work in parallel. While one agent researches fresh topics, another agent uses `list_available_voices` to select the most natural voice actor for the target audience.

Autonomous Asset Matching and Uploads

The `upload_media_asset` tool lets your CrewAI design agent upload custom backgrounds or voiceovers directly to HeyGen. Our agent finds the assets in your local directory, pushes them to the cloud, and hands the asset ID to the video generator. By integrating this tool, your crew doesn't need manual intervention to handle media. The agent can verify the upload using `get_api_status` to ensure the pipeline is clear before triggering a render.

Hierarchical Quality Control and Monitoring

The `get_video_progress` tool enables a CrewAI supervisor agent to track active rendering jobs while other agents prepare the next script. If a render stalls, the supervisor agent can log the issue or re-route the task. Once the video is ready, the supervisor uses `list_generated_videos` to confirm the asset exists before alerting your marketing team. This keeps your production queue moving without requiring constant human oversight.

Setup guide

Set up HeyGen MCP in CrewAI

Prerequisites

Python 3.10+ installed
crewai package (pip install crewai)
Active Vinkius subscription with a valid endpoint token

1

Install CrewAI
Run pip install crewai to install the framework. MCP support is built-in via the mcps parameter.
2

Add the MCP URL to your agent
Pass your Vinkius endpoint directly to the mcps list. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. CrewAI handles tool discovery and caching automatically.
3

Kick off your crew
Create a Crew with your agent and tasks. Call crew.kickoff() — the agent will automatically invoke HeyGen tools as needed.

crew.py

from crewai import Agent, Task, Crew

agent = Agent(
    role="HeyGen Analyst",
    goal="Access and analyze HeyGen data via MCP.",
    backstory="Expert analyst with direct HeyGen access.",
    mcps=[
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ],
)

task = Task(
    description="List recent HeyGen transactions",
    agent=agent,
    expected_output="A summary of recent activity",
)

crew = Crew(agents=[agent], tasks=[task])
result = crew.kickoff()
print(result)

Get your connection token →

Prerequisites

Python 3.10+ installed
crewai + crewai-tools packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install crewai crewai-tools. The MCPServerAdapter handles lifecycle management and tool conversion.
2

Connect with MCPServerAdapter
Use MCPServerAdapter as a context manager with SseServerParameters pointing to your Vinkius endpoint. The adapter automatically manages connection lifecycle.
3

Assign tools and run
Pass the returned mcp_tools to your agent's tools parameter. The adapter converts MCP tools to native BaseTool objects compatible with all CrewAI agents.

crew.py

from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter
from mcp import SseServerParameters

server_params = SseServerParameters(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

with MCPServerAdapter(server_params) as mcp_tools:
    agent = Agent(
        role="HeyGen Analyst",
        goal="Access and analyze HeyGen data via MCP.",
        backstory="Expert analyst with direct HeyGen access.",
        tools=mcp_tools,
    )

    task = Task(
        description="List recent HeyGen transactions",
        agent=agent,
        expected_output="A summary of recent activity",
    )

    crew = Crew(agents=[agent], tasks=[task])
    result = crew.kickoff()
    print(result)

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by HeyGen. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect HeyGen now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about HeyGen MCP in CrewAI

Your writer agent calls `list_available_voices` to read the active list of voices. It matches the voice characteristics with the script's tone and passes the choice to the generator.

Yes, you assign a manager agent to poll `get_video_progress` periodically. This keeps the rest of your CrewAI team free to write scripts or research new topics while the video renders.

Add your endpoint token to the CrewAI configuration. The agents will automatically use `test_heygen_auth` to verify the Vinkius MCP Server connection before starting work.

Yes, you can give your archivist agent access to `remove_video_record`. The agent will search your video list and delete outdated files to keep your workspace clean.

All voice models, video metadata, and media assets are processed directly through HeyGen's enterprise-grade security infrastructure. The Vinkius MCP Server handles your API tokens in an isolated environment, ensuring no raw credentials or video files are exposed to external parties.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript