{"id":30522990,"url":"https://github.com/tuannvm/codex-mcp-server","last_synced_at":"2026-04-11T00:02:29.056Z","repository":{"id":310447060,"uuid":"1039829260","full_name":"tuannvm/codex-mcp-server","owner":"tuannvm","description":"MCP server wrapper for OpenAI Codex CLI that enables Claude Code to leverage Codex's AI capabilities directly.","archived":false,"fork":false,"pushed_at":"2026-01-19T16:25:10.000Z","size":414,"stargazers_count":102,"open_issues_count":13,"forks_count":24,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-21T00:33:50.646Z","etag":null,"topics":["claude-code","codex","cursor","mcp"],"latest_commit_sha":null,"homepage":"https://docs.tuannvm.com/codex-mcp-server","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tuannvm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-18T03:39:12.000Z","updated_at":"2026-01-19T19:57:37.000Z","dependencies_parsed_at":"2025-12-15T06:00:41.203Z","dependency_job_id":null,"html_url":"https://github.com/tuannvm/codex-mcp-server","commit_stats":null,"previous_names":["tuannvm/codex-mcp-server"],"tags_count":25,"template":false,"template_full_name":null,"purl":"pkg:github/tuannvm/codex-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tuannvm%2Fcodex-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tuannvm%2Fcodex-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tuannvm%2Fcodex-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tuannvm%2Fcodex-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tuannvm","download_url":"https://codeload.github.com/tuannvm/codex-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tuannvm%2Fcodex-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28740388,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-24T22:12:27.248Z","status":"ssl_error","status_checked_at":"2026-01-24T22:12:10.529Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code","codex","cursor","mcp"],"created_at":"2025-08-26T19:44:15.630Z","updated_at":"2026-04-11T00:02:28.849Z","avatar_url":"https://github.com/tuannvm.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Codex MCP Server\n\n[![npm version](https://img.shields.io/npm/v/codex-mcp-server.svg)](https://www.npmjs.com/package/codex-mcp-server)\n[![npm downloads](https://img.shields.io/npm/dm/codex-mcp-server.svg)](https://www.npmjs.com/package/codex-mcp-server)\n[![license](https://img.shields.io/npm/l/codex-mcp-server.svg)](https://www.npmjs.com/package/codex-mcp-server)\n\nBridge between Claude and OpenAI's Codex CLI — get AI-powered code analysis, generation, and review right in your editor.\n\n```mermaid\ngraph LR\n    A[Claude Code] --\u003e B[Codex MCP Server]\n    B --\u003e C[Codex CLI]\n    C --\u003e D[OpenAI API]\n\n    style A fill:#FF6B35\n    style B fill:#4A90E2\n    style C fill:#00D4AA\n    style D fill:#FFA500\n```\n\n## Quick Start\n\n### 1. Install Codex CLI\n\n```bash\nnpm i -g @openai/codex\ncodex login --api-key \"your-openai-api-key\"\n```\n\n### 2. Add to Claude Code\n\n```bash\nclaude mcp add codex-cli -- npx -y codex-mcp-server\n```\n\n### 3. Start Using\n\n```\nAsk codex to explain this function\nUse codex to refactor this code for better performance\nUse review to check my uncommitted changes\n```\n\n## One-Click Install\n\n[![VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square\u0026logo=visualstudiocode\u0026logoColor=white)](https://vscode.dev/redirect/mcp/install?name=codex-cli\u0026config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22codex-mcp-server%22%5D%7D)\n[![VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square\u0026logo=visualstudiocode\u0026logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=codex-cli\u0026config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22codex-mcp-server%22%5D%7D)\n[![Cursor](https://img.shields.io/badge/Cursor-Install-00D8FF?style=flat-square\u0026logo=cursor\u0026logoColor=white)](https://cursor.com/en/install-mcp?name=codex\u0026config=eyJ0eXBlIjoic3RkaW8iLCJjb21tYW5kIjoibnB4IC15IGNvZGV4LW1jcC1zZXJ2ZXIiLCJlbnYiOnt9fQ%3D%3D)\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `codex` | AI coding assistant with session support, model selection, and structured output metadata |\n| `review` | AI-powered code review for uncommitted changes, branches, or commits |\n| `websearch` | Web search using Codex CLI with customizable result count and search depth |\n| `listSessions` | View active conversation sessions |\n| `ping` | Test server connection |\n| `help` | Get Codex CLI help |\n\n## Examples\n\n**Code analysis:**\n```\nUse codex to analyze this authentication logic for security issues\n```\n\n**Multi-turn conversations:**\n```\nUse codex with sessionId \"refactor\" to analyze this module\nUse codex with sessionId \"refactor\" to implement your suggestions\n```\nPassing a sessionId creates the session on first use, so listSessions will show\nit (for this server instance) and subsequent calls can resume context.\n\n**Code review:**\n```\nUse review with base \"main\" to check my PR changes\nUse review with uncommitted true to review my local changes\n```\n\n**Advanced options:**\n```\nUse codex with model \"o3\" and reasoningEffort \"high\" for complex analysis\nUse codex with fullAuto true and sandbox \"workspace-write\" for automated tasks\nUse codex with callbackUri \"http://localhost:1234/callback\" for static callbacks\nUse codex to return structuredContent with threadId metadata when available\n```\n\n**Web search:**\n```\nUse websearch with query \"TypeScript 5.8 new features\"\nUse websearch with query \"Rust vs Go performance 2025\" and numResults 15\nUse websearch with query \"React Server Components\" and searchDepth \"full\"\n```\n\n## Requirements\n\n- **Codex CLI v0.75.0+** — Install with `npm i -g @openai/codex` or `brew install codex`\n- **OpenAI API key** — Run `codex login --api-key \"your-key\"` to authenticate\n\n## Codex 0.87 Compatibility\n- **Thread ID + structured output**: When Codex CLI emits `threadId`, this server returns it in content metadata and `structuredContent`, and advertises an `outputSchema` for structured responses.\n\n## Documentation\n\n- **[API Reference](docs/api-reference.md)** — Full tool parameters and response formats\n- **[Session Management](docs/session-management.md)** — How conversations work\n- **[Codex CLI Integration](docs/codex-cli-integration.md)** — Version compatibility and CLI details\n\n## Environment Variables\n- `CODEX_MCP_CALLBACK_URI`: Static MCP callback URI passed to Codex when set (overridden by `callbackUri` tool arg)\n\n## Development\n\n```bash\nnpm install    # Install dependencies\nnpm run dev    # Development mode\nnpm run build  # Build for production\nnpm test       # Run tests\n```\n\n## Related Projects\n\n- **[gemini-mcp-server](https://github.com/tuannvm/gemini-mcp-server)** — MCP server for Gemini CLI with 1M+ token context, web search, and media analysis\n\n## License\n\nISC\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftuannvm%2Fcodex-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftuannvm%2Fcodex-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftuannvm%2Fcodex-mcp-server/lists"}