OpenAI Codex

Codex stores MCP configuration in ~/.codex/config.toml (global) or .codex/config.toml in a trusted project root.

Security

This file contains sensitive API keys. Never commit it to source control. Add .codex/config.toml to your .gitignore.

Option A — CLI

Run this command once. Codex persists the configuration globally:

codex mcp add videoMcp \
  --env GEMINI_API_KEY=your-gemini-key \
  --env Z_AI_API_KEY=your-zai-key \
  --env DASHSCOPE_API_KEY=your-dashscope-key \
  --env MOONSHOT_API_KEY=your-moonshot-key \
  --env MIMO_API_KEY=your-mimo-key \
  --env DEEPGRAM_API_KEY=your-deepgram-key \
  --env ASSEMBLYAI_API_KEY=your-assemblyai-key \
  --env GROQ_API_KEY=your-groq-key \
  --env MINIMAX_API_KEY=your-minimax-key \
  -- video-context-mcp

Verify the server is registered with codex mcp --help or type /mcp inside the Codex TUI.

Option B — config.toml

Add the following to ~/.codex/config.toml (or a project-scoped .codex/config.toml):

[mcp_servers.videoMcp]
command = "video-context-mcp"

[mcp_servers.videoMcp.env]
GEMINI_API_KEY = "your-gemini-key"
Z_AI_API_KEY = "your-zai-key"
DASHSCOPE_API_KEY = "your-dashscope-key"
MOONSHOT_API_KEY = "your-moonshot-key"
MIMO_API_KEY = "your-mimo-key"
DEEPGRAM_API_KEY = "your-deepgram-key"
ASSEMBLYAI_API_KEY = "your-assemblyai-key"
GROQ_API_KEY = "your-groq-key"
MINIMAX_API_KEY = "your-minimax-key"

Where to get API keys

See Video Providers and Audio Providers for links to get each API key, free-tier details, and pricing.