codex-app-mcp

⚡ Host loop (Session v1.2)

Unofficial bridge. Save host tokens:

1. codex_app_session_begin({"goal":"…","host_budget":"small"})

2. Loop codex_app_session_next → do only card (host_cmd | mcp_tool | end)

3. Stop when done=true

Skill codex-mcp v1.0 enforces this. No OAuth in MCP config — CLI login only.

Claude / Cursor orchestrate → Codex app-server works (goals, budgets, policy roots).

Unofficial community project — not OpenAI, Codex, Anthropic, or xAI.
Auth = local codex login (CODEX_HOME). Never put OAuth in MCP config or HTTP bearer.

Install (one command)

curl -fsSL https://raw.githubusercontent.com/zai-one/codex-mcp/main/scripts/install.sh \
  | bash -s -- --project "$HOME/code/my-project"

Windows: irm https://raw.githubusercontent.com/zai-one/codex-mcp/main/scripts/install.ps1 | iex

Then:

codex login
source ~/.config/codex-mcp/env
~/.local/share/codex-mcp/.venv/bin/python ~/.local/share/codex-mcp/scripts/probe_stdio.py

Merge ~/.config/codex-mcp/mcp/claude_desktop.snippet.json → restart → codex_app_status.

Skill (router): codex-mcp — see docs/SKILLS.md

Full easy guide: docs/EASY.md

What it is

Optional

• VPS · FastMCP · Economy

• Skills · Security · Reference