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 CLI for Headless Automation

Use the HeyGen CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.

7 functions 6 read 1 write Bearer token auth

Submit HeyGen feedback View package source

HeyGen CLI for Headless Automation

Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.

Use headless automation when another tool needs a stable local command surface. The HeyGen CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# HeyGen CLI for Headless Automation
kosmokrator integrations:configure heygen --set access_token="$HEYGEN_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call heygen.heygen_list_videos '{"limit":1,"offset":1}' --json

Discovery Before Execution

Agents and scripts can inspect HeyGen docs and schemas before choosing a function.

kosmo integrations:docs heygen --json
kosmo integrations:docs heygen.heygen_list_videos --json
kosmo integrations:schema heygen.heygen_list_videos --json
kosmo integrations:search "HeyGen" --json
kosmo integrations:list --json

Useful HeyGen CLI Functions

Function	Type	Parameters	Description
`heygen.heygen_list_videos`	Read	limit, offset	List generated videos from HeyGen. Returns video IDs, statuses, and metadata. Use limit and offset for pagination.
`heygen.heygen_get_video`	Read	video_id	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	video_inputs, dimension, test	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	none	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	none	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	none	Get the current authenticated HeyGen user's account information, including plan details, remaining credits, and usage statistics.
`heygen.heygen_list_templates`	Read	limit, offset	List available video templates from HeyGen. Returns template IDs, names, thumbnails, and metadata. Use limit and offset for pagination.

Automation Notes

Use --json for machine-readable output.
Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
Configure read/write policy before unattended runs; use --force only for trusted automation.
Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.

Related HeyGen CLI Pages

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