MCP servers
MCP
~/.codex/config.toml
Vendor docs
config
| name | type | required | meaning | concept | |
|---|---|---|---|---|---|
| args | string |
Arguments to pass to the server.
|
docs ↗ | ||
| auth | string |
Authentication to try after configured bearer tokens and
|
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 ↗ |