| Name | codex-as-mcp JSON |
| Version |
2025.9.4
JSON |
| download |
| home_page | None |
| Summary | MCP server that provides access to codex CLI for code generation and review |
| upload_time | 2025-09-03 07:32:35 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.11 |
| license | None |
| keywords |
ai
code-generation
codex
mcp
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# codex-as-mcp
[中文版](./README.zh-CN.md)
Enable Claude Code, Cursor and other AI tools to call Codex for task execution. Plus/Pro/Team subscribers can maximize GPT-5 usage without additional costs.
## Setup
### 1. Install Codex CLI
**⚠️ Requires Codex CLI version >= 0.25.0**
```bash
npm install -g @openai/codex@latest
codex login
# Verify version
codex --version
```
> **Important**: This MCP server uses `--sandbox` and `--ask-for-approval` flags that require Codex CLI v0.25.0 or later. Earlier versions are not supported.
### 2. Configure MCP
Add to your `.mcp.json`:
**Safe Mode (Default):**
```json
{
"mcpServers": {
"codex": {
"type": "stdio",
"command": "uvx",
"args": ["codex-as-mcp@latest"]
}
}
}
```
**Writable Mode:**
```json
{
"mcpServers": {
"codex": {
"type": "stdio",
"command": "uvx",
"args": ["codex-as-mcp@latest", "--yolo"]
}
}
}
```
Or use Claude Code commands:
```bash
# Safe mode (default)
claude mcp add codex-as-mcp -- uvx codex-as-mcp@latest
# Writable mode
claude mcp add codex-as-mcp -- uvx codex-as-mcp@latest --yolo
```
## Tools
The MCP server exposes two tools:
- `codex_execute(prompt, work_dir)` - General purpose codex execution
- `codex_review(review_type, work_dir, target?, prompt?)` - Specialized code review
If you have any other use case requirements, feel free to open issue.
## Safety
- **Safe Mode**: Default read-only operations protect your environment
- **Writable Mode**: Use `--yolo` flag when you need full codex capabilities
- **Sequential Execution**: Prevents conflicts from parallel agent operations
## Local test
```shell
uv run mcp dev src/codex_as_mcp/server.py
```
Raw data
{
"_id": null,
"home_page": null,
"name": "codex-as-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "ai, code-generation, codex, mcp",
"author": null,
"author_email": "kky <kky42@example.com>",
"download_url": "https://files.pythonhosted.org/packages/b9/35/60b8eb0d0429227b878829a559a84b83bbfb99f66d06dfa223e3f0b167e7/codex_as_mcp-2025.9.4.tar.gz",
"platform": null,
"description": "# codex-as-mcp\n\n[\u4e2d\u6587\u7248](./README.zh-CN.md)\n\nEnable Claude Code, Cursor and other AI tools to call Codex for task execution. Plus/Pro/Team subscribers can maximize GPT-5 usage without additional costs.\n\n## Setup\n\n### 1. Install Codex CLI\n\n**\u26a0\ufe0f Requires Codex CLI version >= 0.25.0**\n\n```bash\nnpm install -g @openai/codex@latest\ncodex login\n\n# Verify version\ncodex --version\n```\n\n> **Important**: This MCP server uses `--sandbox` and `--ask-for-approval` flags that require Codex CLI v0.25.0 or later. Earlier versions are not supported.\n\n### 2. Configure MCP\n\nAdd to your `.mcp.json`:\n**Safe Mode (Default):**\n```json\n{\n \"mcpServers\": {\n \"codex\": {\n \"type\": \"stdio\",\n \"command\": \"uvx\",\n \"args\": [\"codex-as-mcp@latest\"]\n }\n }\n}\n```\n\n**Writable Mode:**\n```json\n{\n \"mcpServers\": {\n \"codex\": {\n \"type\": \"stdio\",\n \"command\": \"uvx\",\n \"args\": [\"codex-as-mcp@latest\", \"--yolo\"]\n }\n }\n}\n```\n\nOr use Claude Code commands:\n```bash\n# Safe mode (default)\nclaude mcp add codex-as-mcp -- uvx codex-as-mcp@latest\n\n# Writable mode\nclaude mcp add codex-as-mcp -- uvx codex-as-mcp@latest --yolo\n```\n\n## Tools\n\nThe MCP server exposes two tools:\n- `codex_execute(prompt, work_dir)` - General purpose codex execution\n- `codex_review(review_type, work_dir, target?, prompt?)` - Specialized code review\n\nIf you have any other use case requirements, feel free to open issue.\n\n## Safety\n\n- **Safe Mode**: Default read-only operations protect your environment\n- **Writable Mode**: Use `--yolo` flag when you need full codex capabilities\n- **Sequential Execution**: Prevents conflicts from parallel agent operations\n\n## Local test\n```shell\nuv run mcp dev src/codex_as_mcp/server.py\n```",
"bugtrack_url": null,
"license": null,
"summary": "MCP server that provides access to codex CLI for code generation and review",
"version": "2025.9.4",
"project_urls": {
"Homepage": "https://github.com/kky42/codex-as-mcp",
"Issues": "https://github.com/kky42/codex-as-mcp/issues",
"Repository": "https://github.com/kky42/codex-as-mcp"
},
"split_keywords": [
"ai",
" code-generation",
" codex",
" mcp"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "c1f8e2d2ce491054ce3b91e18e8f14f20c9de336f82a9778ae55947b212ef29c",
"md5": "e49ae91bcbb0501ff93998029daeac59",
"sha256": "f7fde6e7756a486a2e635d6e5269923c8a1a6854e55db0aa8ae5aefc05efe47b"
},
"downloads": -1,
"filename": "codex_as_mcp-2025.9.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e49ae91bcbb0501ff93998029daeac59",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 7501,
"upload_time": "2025-09-03T07:32:34",
"upload_time_iso_8601": "2025-09-03T07:32:34.428200Z",
"url": "https://files.pythonhosted.org/packages/c1/f8/e2d2ce491054ce3b91e18e8f14f20c9de336f82a9778ae55947b212ef29c/codex_as_mcp-2025.9.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "b93560b8eb0d0429227b878829a559a84b83bbfb99f66d06dfa223e3f0b167e7",
"md5": "03df6128ec3f326ff04a180a58d0c99e",
"sha256": "5caf53cac748895efedf3395900dd954971c147af44cf0a6539b3e007e7d5290"
},
"downloads": -1,
"filename": "codex_as_mcp-2025.9.4.tar.gz",
"has_sig": false,
"md5_digest": "03df6128ec3f326ff04a180a58d0c99e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 52623,
"upload_time": "2025-09-03T07:32:35",
"upload_time_iso_8601": "2025-09-03T07:32:35.749061Z",
"url": "https://files.pythonhosted.org/packages/b9/35/60b8eb0d0429227b878829a559a84b83bbfb99f66d06dfa223e3f0b167e7/codex_as_mcp-2025.9.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-03 07:32:35",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "kky42",
"github_project": "codex-as-mcp",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "codex-as-mcp"
}
