HeyGen MCP server: URL, setup for Claude, and credits

HeyGen MCP runs at mcp.heygen.com/mcp/v1/. Add it to Claude Code or Claude, sign in with OAuth, and videos use your HeyGen plan's credits.

5 min readSume
All posts

HeyGen MCP is HeyGen's remote MCP server at https://mcp.heygen.com/mcp/v1/. Add it as a custom connector in Claude, Claude Code, Cursor, Gemini CLI, or another MCP client, sign in to HeyGen through OAuth instead of an API key, and your agent can create avatar videos with the credits already in your HeyGen plan.

The HeyGen facts come from its MCP page and its developer docs for the remote MCP server, Claude Code, and Claude, read on 2026-09-28. Sume has no connection to HeyGen's server. For HeyGen's REST API, see HeyGen Video Agent API and pricing.

How do I add HeyGen MCP to Claude Code or Claude?

HeyGen's Claude Code guide says to run this in your terminal, not inside Claude Code; add -s user to make the server available in all projects:

  • Authenticate: run /mcp inside Claude Code and follow the browser-based OAuth flow. claude mcp list should then show heygen as connected.
  • Claude on the web: go to + → Connector → Manage Connector → + Add custom connector, name it HeyGen, enter the URL, click Connect, and approve access on HeyGen's page.
  • Other clients: HeyGen lists Claude (Web, Desktop, and Code), Codex CLI, Cursor, Gemini CLI, Lovable, Manus, Superhuman, and OpenAI, with a setup guide for each. A custom agent can point at the same endpoint, but HeyGen uses domain whitelisting, so an agent on a domain that isn't whitelisted must request access first.
  • Finished videos also appear on the Projects page of your HeyGen dashboard.
claude mcp add --transport http heygen https://mcp.heygen.com/mcp/v1/

Does HeyGen's MCP cost extra?

No, according to HeyGen. Its FAQ says video generation uses the premium credits included in your existing HeyGen plan, with no separate API charges or additional billing. MCP is available on all plans, including free accounts, and HeyGen recommends the Creator plan or above for heavier usage. Access is OAuth tied to your HeyGen account, so there is no API key to rotate.

What can the agent do through HeyGen MCP?

HeyGen's docs list tools in several groups. The main ones:

From HeyGen's remote MCP overview, read 2026-09-28.
GroupExample toolsWhat HeyGen says they do
Video Agentcreate_video_agent, get_video_agent_sessionOne-shot video from a prompt: the agent handles script, avatar, scenes, and rendering
Videoscreate_video, get_videoVideo from a HeyGen avatar or an image, with a script or recorded audio; Avatar III, IV, or V engine, IV by default
Templatesgenerate_from_templateVideo from a template by replacing its variables
Avatarscreate_avatar, create_avatar_consentAvatar from an image, footage, or a text prompt; consent before a private avatar is used
Lipsynccreate_lipsyncNew audio on an existing video, with lips re-animated to match
Accountget_current_userProfile, remaining credits or balance, and billing details

How do Sume's avatar tools over MCP differ?

Sume's hosted MCP server at https://mcp.sume.com/mcp also has avatar tools, with different rules. Sume basics says hosted MCP still works but is not the primary path today. From its tools docs and Avatar videos page:

  • Read tools such as avatars_list and avatars_search work in a read-only session; avatars_create, avatar-videos_create, and avatar-image-to-video_create are paid and return insufficient_scope until you turn Write on at consent.
  • The documented playbook: call the paid tool with dry_run=true, repeat without it to submit, then wait with jobs_status or jobs_wait and read jobs_result.
  • 720p is the documented resolution for avatar videos. Speech is English only in current code.
  • Spend comes from the Sume workspace wallet, per job. Make AI UGC videos with Claude walks through the full flow.

Sources

Related posts

More in Integrations

All Integrations posts

Written by Sume