Codex - HeyGen Documentation

Make HeyGen videos from Codex with a plain-language prompt. Pick the tab for the Codex you use.

Codex app
Codex CLI

Install the HeyGen plugin. It’s the same plugin as in ChatGPT, and it shows videos and voices as interactive cards in the chat.

Install the HeyGen plugin

Open the Plugins tab, find HeyGen, and select the plus button.

Connect your HeyGen account

Start a new chat. When Codex asks, sign in to HeyGen in your browser and approve access. New to HeyGen? You can create an account during this step.

Ask for a video

Make a 60-second HeyGen explainer about our new API endpoints.

Codex writes the script, picks the avatar, and renders the video. Finished videos also appear in Projects in HeyGen.

Can't install the plugin? Add the MCP server instead

Plugin availability can depend on your plan, workspace settings, and region. To connect HeyGen’s MCP server directly:

Open Settings, then select MCP servers.
Select Add server.
Name it HeyGen, choose Streamable HTTP, and enter https://mcp.heygen.com/mcp/v1.
Save the server, then select Restart.

Add HeyGen’s MCP server. Sign-in uses your HeyGen account, and usage draws on your plan’s credits. Results show as text and links.

Add the server

Run this in your terminal:

codex mcp add heygen --url https://mcp.heygen.com/mcp/v1

Keep --url and leave off the trailing slash: Codex needs both to find HeyGen’s sign-in.

Connect your HeyGen account

Codex opens HeyGen in your browser. Approve access and you’re set. To sign in again later, run codex mcp login heygen.

Ask for a video

Make a 60-second HeyGen explainer about our new API endpoints.

Codex writes the script, picks the avatar, and renders the video. Finished videos also appear in Projects in HeyGen.

Prefer the HeyGen CLI?

Codex can run the HeyGen CLI in your terminal instead. Install it and sign in:

curl -fsSL https://static.heygen.ai/cli/install.sh | bash
heygen auth login

heygen auth login asks for an API key, which uses API billing. To use your HeyGen plan instead, run heygen auth login --oauth. Then ask Codex to make a video and it calls heygen for you.

The Codex app and Codex CLI share MCP settings, so a server you add in one also appears in the other.

If you set HeyGen up without the plugin, add HeyGen Skills to Codex for sharper scripts and scene structure. The plugin already includes them.

Troubleshooting

HeyGen tools missing after installing the plugin: start a new chat. Plugins load when a chat starts.
No authorization support detected: the URL has a trailing slash. Run codex mcp remove heygen, then add it again with the command above.
OAuth login is only supported for streamable HTTP servers: the server was added without --url. Remove it and add it again with the command above.
Tools missing after sign-in in Codex CLI: restart Codex CLI.