Codex

Connect Clean to the OpenAI Codex CLI — locally over stdio or through the cloud.

Codex reads MCP servers from ~/.codex/config.toml.

The local edition runs as a stdio server. The simplest way to register it:

codex mcp add clean -- python -m clean.local.mcp_server

Or add it to ~/.codex/config.toml directly:

[mcp_servers.clean]
command = "python"
args = ["-m", "clean.local.mcp_server"]

To pin a default repo, add it to args: ["-m", "clean.local.mcp_server", "--repo", "owner/repo"]. Install Clean from source first.

Verify

Run Codex and ask it to list its MCP tools. You should see Clean's tools — search_code, expand_result, get_source, get_file_tree, list_repos (plus index_repo and delete_repo locally).

Codex

Verify

On this page