Client Configuration Guide

How to Configure MCP in Codex

Codex MCP uses TOML configuration shared by the CLI, IDE extension and supported desktop host.

Official Codex Docs

macOS

~/.codex/config.toml

Windows

%USERPROFILE%\.codex\config.toml

Linux

~/.codex/config.toml

Setup and verification

Configuration: config.toml / mcp_servers / TOML

Documentation reviewed: 2026-11-02. This is not a runtime test or security audit.

  1. Open ~/.codex/config.toml, or .codex/config.toml in a trusted project. Respect a custom Codex home when configured.
  2. Merge the generated [mcp_servers."name"] TOML tables. Do not paste JSON or duplicate an existing table.
  3. Restart the client, inspect MCP server status and authenticate remote OAuth servers when required.

The reviewed adapter supports STDIO and Streamable HTTP, not legacy SSE. HTTP headers use http_headers. Do not replace the rest of config.toml.

Review every command and requested permission. Merge only the relevant server entries; do not overwrite unrelated settings. Keep credentials out of version control.

Reviewed configurations for Codex

2 servers with a documentation-reviewed configuration for at least one platform. Check the platform selector before copying.

Knowledge Graph Memory
Knowledge Graph Memory
@modelcontextprotocol/server-memory•Model Context Protocol

Store and retrieve entities, relations and observations in a persistent local knowledge graph.

create_entitiescreate_relationsadd_observations+6 more
91.8KUnknown
AI & Multi-Agent
Sequential Thinking
Sequential Thinking
@modelcontextprotocol/server-sequential-thinking•Model Context Protocol

Organize problem solving into revisable, branching thought steps through an MCP tool.

sequential_thinking
91.8KUnknown
AI & Multi-Agent