MCP servers
MCP
~/.codex/config.toml
Vendor docs
config
| name | type | required | meaning | concept | |
|---|---|---|---|---|---|
| args | string | Arguments to pass to the server. | docs ↗ | ||
| bearer_token_env_var | string | Environment variable name for a bearer token to send in `Authorization`. | docs ↗ | ||
| command | string | yes | The command that starts the server. | docs ↗ | |
| cwd | string | Working directory to start the server from. | docs ↗ | ||
| default_tools_approval_mode | string | Default approval behavior for | docs ↗ | ||
| disabled_tools | string | Tool deny list (applied after `enabled_tools`). | docs ↗ | ||
| enabled | string | Set `false` to disable a server without deleting it. | docs ↗ | ||
| enabled_tools | string | Tool allow list. | docs ↗ | ||
| env | string | Environment variables to set for the server. | docs ↗ | ||
| env_http_headers | string | Map of header names to environment variable names (values pulled from the environment). | docs ↗ | ||
| env_vars | string | Environment variables to allow and forward. | docs ↗ | ||
| experimental_environment | string | Set to `remote` to start the stdio | docs ↗ | ||
| http_headers | string | Map of header names to static values. | docs ↗ | ||
| required | string | Set `true` to make startup fail if this enabled server can't initialize. | docs ↗ | ||
| startup_timeout_sec | string | Timeout (seconds) for the server to start. Default: `10`. | docs ↗ | ||
| tool_timeout_sec | string | Timeout (seconds) for the server to run a tool. Default: `60`. | docs ↗ | ||
| tools.<tool>.approval_mode | string | Per-tool approval behavior override. | docs ↗ | ||
| url | string | yes | The server address. | docs ↗ |