A
licenseA
qualityD
maintenanceMCP server for Codex CLI — tmux persistence, git worktree isolation, async dispatch.
4
1
MIT
codex-app-mcp
by zai-one
This server provides an unofficial MCP bridge to control a Codex app-server, enabling autonomous coding sessions, thread management, goal-driven execution, file system access, command execution, and more.
Key capabilities:
Session & Goal Management: Start, pause, resume, and complete autonomous goals with token budgets and lifecycle control; manage persistent threads (create, fork, archive, compact, rollback, terminal sessions); start, steer, or interrupt individual turns with prompt, image, and sandbox level support.
Status, Diagnostics & Discovery: Probe server status, run read-only diagnostics on account/config/sandbox readiness, and discover available models, effort levels, collaboration modes, MCP servers, apps, plugins, skills, hooks, and account details.
File Operations: Governed read, write, list, copy, remove, mkdir, and watch operations on allowlisted filesystem roots.
Command & Process Execution: Run sandboxed command/exec sessions with TTY, timeouts, and output controls; spawn, write to, resize, and kill unsandboxed processes (requires
CODEX_APP_MCP_ALLOW_FULL_ACCESS=1).Event Handling & Background Jobs: Poll cursor-paginated thread events, list pending approvals, respond to deferred requests; create, inspect, resume, or cancel durable background goal/turn jobs backed by SQLite; set up timezone-aware RRULE-based schedules with misfire policies and retries.
Code Review & Isolated Lanes: Run native code reviews (inline or detached) against uncommitted changes, branches, or commits; prepare, list, diff, run, and review isolated git worktree lanes for parallel autonomous work.
External Tool Integration: Call explicitly allowlisted downstream MCP/SaaS tools.
Admin & Configuration: Typed access to account management, configuration, apps/plugins/skills, environment variables, search, memory, realtime audio/speech, and remote-control operations.
Protocol, Runtime & Raw RPC: Inspect the app-server’s versioned JSON schema; read gateway metrics and restart the connection; perform forward-compatible raw RPC calls (read-only or full with explicit allowlist).
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@codex-app-mcpstart a new thread to investigate the production outage"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
codex-app-mcp
⚡ Host loop (Session v1.2)
Unofficial bridge. Save host tokens:
codex_app_session_begin({"goal":"…","host_budget":"small"})Loop
codex_app_session_next→ do onlycard(host_cmd|mcp_tool|end)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 = localcodex login(CODEX_HOME). Never put OAuth in MCP config or HTTP bearer.
Related MCP server: codex-mcp-server
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.pyMerge ~/.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
Language | Page |
Easy (canonical) | |
EN / RU / 中文 / ES | docs/install/ (short pointers) |
What it is
Host | Claude, Cursor, … (stdio or bearer HTTP) |
Worker | Codex CLI / app-server on same machine or VPS |
Why | Save host tokens under |
Economy |
|
Optional
Maintenance
UpdatingMaintainers
UpdatingResponse time
–Release cycle
0Releases (12mo)
Commit activity
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseCqualityBmaintenanceBridges MCP clients with local Codex CLI to execute autonomous coding tasks, manage threads, and inspect history via SQLite state.137654Apache 2.0
- AlicenseAqualityAmaintenanceMCP server that wraps Codex CLI as a subprocess, exposing code execution, web search, and structured output as Model Context Protocol tools.8813MIT
- AlicenseNot gradedqualityBmaintenanceAn experimental MCP server for MNCS-native development and evidence control, enabling Codex to manage project authority, candidate lineage, evidence gaps, and evaluator-mode boundaries.Apache 2.0
Related MCP Connectors
A paid remote MCP for OpenAI Codex agent coordination MCP, built to return verdicts, receipts, usage
Hosted AgentLux MCP server for marketplace, identity, creator, services, and social flows.
Personal assistant MCP server with search, execute, packages, jobs, secrets, and integrations.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/zai-one/codex-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server