Can I use HeyGen as a CLI?

Yes. KosmoKrator exposes a HeyGen CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose HeyGen through MCP?

Yes. The KosmoKrator MCP gateway can expose selected HeyGen tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are HeyGen credentials stored?

HeyGen credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for HeyGen MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

HeyGen MCP, CLI, and Lua Integration for AI Agents

HeyGen integration docs for AI agents: MCP gateway setup, HeyGen CLI commands, Lua API reference, credentials, and function schemas.

7 functions 6 read 1 write Bearer token auth

Submit HeyGen feedback View package source

HeyGen for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Machine-Readable Metadata

integration_slug: heygen
route_slug: heygen
package: heygen
auth_strategy: bearer_token Bearer token
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true
supports_multi_account: true

Quick Links

Lua APIAgent-facing namespace and function reference. HeyGen CLIHeadless setup and direct function calls. HeyGen MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

HeyGen MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for HeyGen.

Claude Code HeyGen MCP setup for Claude Code. Cursor HeyGen MCP setup for Cursor. Codex HeyGen MCP setup for Codex. OpenAI Agents HeyGen MCP setup for OpenAI Agents SDK. Claude Agent SDK HeyGen MCP setup for Claude Agent SDK. Vercel AI SDK HeyGen MCP setup for Vercel AI SDK. LangChain HeyGen MCP setup for LangChain. LangGraph HeyGen MCP setup for LangGraph. CrewAI HeyGen MCP setup for CrewAI. MCP clients HeyGen MCP setup for Generic MCP Clients.

HeyGen CLI Matrix

Use these pages for direct HeyGen CLI workflows in scripts, CI, cron, and agent wrappers.

CI HeyGen CLI for CI. Cron Jobs HeyGen CLI for cron jobs. Shell Scripts HeyGen CLI for shell scripts. Headless Automation HeyGen CLI for headless automation. Coding Agents HeyGen CLI for coding agents.

Function Catalog

Function	Type	Parameters	Description
`heygen.heygen_list_videos`	Read `read`	2	List generated videos from HeyGen. Returns video IDs, statuses, and metadata. Use limit and offset for pagination.
`heygen.heygen_get_video`	Read `read`	1	Get the status and details of a specific HeyGen video. Returns the video status (pending, processing, completed, failed), download URL when ready, and metadata.
`heygen.heygen_create_video`	Write `write`	3	Generate a new AI video on HeyGen. Provide video_inputs defining scenes (avatar, voice, script), optional dimensions, and test mode. Returns a video_id to track generation progress.
`heygen.heygen_list_avatars`	Read `read`	0	List all available talking avatars from HeyGen. Returns avatar IDs, names, preview images, and supported styles. Use avatar IDs when creating videos.
`heygen.heygen_list_voices`	Read `read`	0	List all available voices from HeyGen. Returns voice IDs, display names, supported languages, gender, and preview audio URLs. Use voice IDs when creating videos.
`heygen.heygen_get_current_user`	Read `read`	0	Get the current authenticated HeyGen user's account information, including plan details, remaining credits, and usage statistics.
`heygen.heygen_list_templates`	Read `read`	2	List available video templates from HeyGen. Returns template IDs, names, thumbnails, and metadata. Use limit and offset for pagination.