mcp.md Codex Docs, 2026-02-19 20:37 UTC → 2026-04-22 00:42 UTC

1# Model Context Protocol1# Model Context Protocol

2 2 

3Give Codex access to third-party tools and context

4 

5Model Context Protocol (MCP) connects models to tools and context. Use it to give Codex access to third-party documentation, or to let it interact with developer tools like your browser or Figma.3Model Context Protocol (MCP) connects models to tools and context. Use it to give Codex access to third-party documentation, or to let it interact with developer tools like your browser or Figma.

6 4 

7Codex supports MCP servers in both the CLI and the IDE extension.5Codex supports MCP servers in both the CLI and the IDE extension.

60- `env` (optional): Environment variables to set for the server.58- `env` (optional): Environment variables to set for the server.

61- `env_vars` (optional): Environment variables to allow and forward.59- `env_vars` (optional): Environment variables to allow and forward.

62- `cwd` (optional): Working directory to start the server from.60- `cwd` (optional): Working directory to start the server from.

61- `experimental_environment` (optional): Set to `remote` to start the stdio

62 server through a remote executor environment when one is available.

63 

64`env_vars` can contain plain variable names or objects with a source:

65 

66```toml

67env_vars = ["LOCAL_TOKEN", { name = "REMOTE_TOKEN", source = "remote" }]

68```

69 

70String entries and `source = "local"` read from Codex's local environment.

71`source = "remote"` reads from the remote executor environment and requires

72remote MCP stdio.

63 73 

64#### Streamable HTTP servers74#### Streamable HTTP servers

65 75 

77- `enabled_tools` (optional): Tool allow list.87- `enabled_tools` (optional): Tool allow list.

78- `disabled_tools` (optional): Tool deny list (applied after `enabled_tools`).88- `disabled_tools` (optional): Tool deny list (applied after `enabled_tools`).

79 89 

80If your OAuth provider requires a static callback URI, set the top-level `mcp_oauth_callback_port` in `config.toml`. If unset, Codex binds to an ephemeral port.90If your OAuth provider requires a fixed callback port, set the top-level `mcp_oauth_callback_port` in `config.toml`. If unset, Codex binds to an ephemeral port.

91 

92If your MCP OAuth flow must use a specific callback URL (for example, a remote Devbox ingress URL or a custom callback path), set `mcp_oauth_callback_url`. Codex uses this value as the OAuth `redirect_uri` while still using `mcp_oauth_callback_port` for the callback listener port. Local callback URLs (for example `localhost`) bind on the local interface; non-local callback URLs bind on `0.0.0.0` so the callback can reach the host.

93 

94If the MCP server advertises `scopes_supported`, Codex prefers those

95server-advertised scopes during OAuth login. Otherwise, Codex falls back to the

96scopes configured in `config.toml`.

81 97 

82#### config.toml examples98#### config.toml examples

83 99 

85[mcp_servers.context7]101[mcp_servers.context7]

86command = "npx"102command = "npx"

87args = ["-y", "@upstash/context7-mcp"]103args = ["-y", "@upstash/context7-mcp"]

104env_vars = ["LOCAL_TOKEN"]

88 105 

89[mcp_servers.context7.env]106[mcp_servers.context7.env]

90MY_ENV_VAR = "MY_ENV_VALUE"107MY_ENV_VAR = "MY_ENV_VALUE"

91```108```

92 109 

110```toml

111# Optional MCP OAuth callback overrides (used by `codex mcp login`)

112mcp_oauth_callback_port = 5555

113mcp_oauth_callback_url = "https://devbox.example.internal/callback"

114```

115 

93```toml116```toml

94[mcp_servers.figma]117[mcp_servers.figma]

95url = "https://mcp.figma.com/mcp"118url = "https://mcp.figma.com/mcp"

111 134 

112The list of MCP servers keeps growing. Here are a few common ones:135The list of MCP servers keeps growing. Here are a few common ones:

113 136 

114- [OpenAI Docs MCP](/resources/docs-mcp): Search and read OpenAI developer docs.137- [OpenAI Docs MCP](/learn/docs-mcp): Search and read OpenAI developer docs.

115- [Context7](https://github.com/upstash/context7): Connect to up-to-date developer documentation.138- [Context7](https://github.com/upstash/context7): Connect to up-to-date developer documentation.

116- Figma [Local](https://developers.figma.com/docs/figma-mcp-server/local-server-installation/) and [Remote](https://developers.figma.com/docs/figma-mcp-server/remote-server-installation/): Access your Figma designs.139- Figma [Local](https://developers.figma.com/docs/figma-mcp-server/local-server-installation/) and [Remote](https://developers.figma.com/docs/figma-mcp-server/remote-server-installation/): Access your Figma designs.

117- [Playwright](https://www.npmjs.com/package/@playwright/mcp): Control and inspect a browser using Playwright.140- [Playwright](https://www.npmjs.com/package/@playwright/mcp): Control and inspect a browser using Playwright.