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.

data

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.

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.

Agent Surfaces

HeyGen CLIHeadless setup, JSON output, direct function calls. HeyGen MCPExpose selected tools to local MCP clients. HeyGen LuaAgent-facing namespace and Lua reference. FeedbackReport missing tools, auth issues, or bad metadata.

Machine-Readable Metadata

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

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.