MCP servers for Codex

OpenAI · Terminal agent

How to add an MCP server

  • Codex is OpenAI's coding agent.
  • Run codex mcp add <name> --env KEY=value -- <command> for a local server, or codex mcp add <name> --url <https-url> for a remote server.
  • Or edit ~/.codex/config.toml. Each server uses a [mcp_servers.<name>] table.
  • A local server uses command, args, and env. A remote server uses url. Set bearer_token_env_var to the env var storing the token, and use http_headers for other headers.
  • Codex documents streamable HTTP for remote servers. It does not document SSE.
  • Vendor docs: Codex MCP docs.

MCP servers that work with Codex

Skills

  • Skills are folders containing a SKILL.md file. Codex reads them from .agents/skills in a project and $HOME/.agents/skills for every project.
  • Run npx skills add owner/repo --skill name -a codex to install a skill from a GitHub repository into .agents/skills/.
  • Vendor docs: Build skills for Codex.