Is Codex Bridge safe to use?

Codex Bridge has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.

How do I install Codex Bridge?

Codex Bridge supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can Codex Bridge do?

Codex Bridge provides 2 tools: query, analyze_files. See the full tools list on the server page for descriptions and parameters.

What AI clients work with Codex Bridge?

Codex Bridge is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.

Is Codex Bridge actively maintained?

Codex Bridge is less actively maintained — last commit was 183 days ago. It has 108 GitHub stars.

Codex Bridge

Name: Codex Bridge
Author: eLyiN

@openai/codex-cli · by eLyiN

A lightweight MCP server bridging AI agents to OpenAI models via official CLI

108 2 tools GitHub npm PyPI

No known CVEs

MIT license

Stale

Last commit 183d ago

Works with most clients

Transport: stdio, http

2 tools · ~184 tok

Grade A · 0.1% of 200K ctx

Edit this pageView history

AI / ML Developer Tools

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "codex-bridge": {
      "env": {},
      "args": [
        "codex-bridge"
      ],
      "command": "uvx"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/codex-bridge)](https://mcppedia.org/s/codex-bridge)

Read me

What Codex Bridge does

A lightweight MCP (Model Context Protocol) server that enables AI coding assistants to interact with OpenAI's Codex AI through the official CLI. Works with Claude Code, Cursor, VS Code, and other MCP-compatible clients. Designed for simplicity, reliability, and seamless integration.

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

npx -y '@openai/codex-cli' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

80/100across 5 weighted dimensions

How we score →

0255075100

−20

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked @openai/codex-cli against OSV.dev.

Inventory

Tools (2)

Click any tool to inspect its schema.

~184 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Codex Bridge safe to use?: Codex Bridge has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.
How do I install Codex Bridge?: Codex Bridge supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can Codex Bridge do?: Codex Bridge provides 2 tools: query, analyze_files. See the full tools list on the server page for descriptions and parameters.
What AI clients work with Codex Bridge?: Codex Bridge is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.
Is Codex Bridge actively maintained?: Codex Bridge is less actively maintained — last commit was 183 days ago. It has 108 GitHub stars.

Similar servers

Others in ai-ml / developer-tools

View all →

Sequential Thinking MCP Server98

Dynamic problem-solving through sequential thought chains

87.8k 1

XcodeBuildMCP97

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0k 2

Context797

Context7 Platform -- Up-to-date code documentation for LLMs and AI code editors

58.3k 2

XcodeBuildMCP97

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

6.0k 1

MCP Security Weekly

Get CVE alerts and security updates for Codex Bridge and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

Edit this pageView history

AI / ML Developer Tools

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "codex-bridge": {
      "env": {},
      "args": [
        "codex-bridge"
      ],
      "command": "uvx"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/codex-bridge)](https://mcppedia.org/s/codex-bridge)

Read me

What Codex Bridge does

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

npx -y '@openai/codex-cli' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

README

Codex Bridge

✨ Features

Direct Codex CLI Integration: Zero API costs using official Codex CLI
Simple MCP Tools: Two core functions for basic queries and file analysis
Stateless Operation: No sessions, caching, or complex state management
Production Ready: Robust error handling with configurable timeouts (default: 90 seconds)
Minimal Dependencies: Only requires mcp>=1.0.0 and Codex CLI
Easy Deployment: Support for both uvx and traditional pip installation
Universal MCP Compatibility: Works with any MCP-compatible AI coding assistant

🚀 Quick Start

Prerequisites

Install Codex CLI:
```
npm install -g @openai/codex-cli
```
Authenticate with Codex:
```
codex
```
Verify installation:
```
codex --version
```

Installation

🎯 Recommended: PyPI Installation

# Install from PyPI
pip install codex-bridge

# Add to Claude Code with uvx (recommended)
claude mcp add codex-bridge -s user -- uvx codex-bridge

Alternative: From Source

# Clone the repository
git clone https://github.com/shelakh/codex-bridge.git
cd codex-bridge

# Build and install locally
uvx --from build pyproject-build
pip install dist/*.whl

# Add to Claude Code
claude mcp add codex-bridge -s user -- uvx codex-bridge

Development Installation

# Clone and install in development mode
git clone https://github.com/shelakh/codex-bridge.git
cd codex-bridge
pip install -e .

# Add to Claude Code (development)
claude mcp add codex-bridge-dev -s user -- python -m src

🌐 Multi-Client Support

Codex Bridge works with any MCP-compatible AI coding assistant - the same server supports multiple clients through different configuration methods.

Supported MCP Clients

Claude Code ✅ (Default)
Cursor ✅
VS Code ✅
Windsurf ✅
Cline ✅
Void ✅
Cherry Studio ✅
Augment ✅
Roo Code ✅
Zencoder ✅
Any MCP-compatible client ✅

Configuration Examples

Claude Code (Default)

# Recommended installation
claude mcp add codex-bridge -s user -- uvx codex-bridge

# Development installation
claude mcp add codex-bridge-dev -s user -- python -m src

Cursor

Global Configuration (~/.cursor/mcp.json):

{
  "mcpServers": {
    "codex-bridge": {
      "command": "uvx",
      "args": ["codex-bridge"],
      "env": {}
    }
  }
}

Project-Specific (.cursor/mcp.json in your project):

{
  "mcpServers": {
    "codex-bridge": {
      "command": "uvx",
      "args": ["codex-bridge"],
      "env": {}
    }
  }
}

Go to: Settings → Cursor Settings → MCP → Add new global MCP server

VS Code

Configuration (.vscode/mcp.json in your workspace):

{
  "servers": {
    "codex-bridge": {
      "type": "stdio",
      "command": "uvx",
      "args": ["codex-bridge"]
    }
  }
}

Alternative: Through Extensions

Open Extensions view (Ctrl+Shift+X)
Search for MCP extensions
Add custom server with command: uvx codex-bridge

... View full README on GitHub

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

80/100across 5 weighted dimensions

How we score →

0255075100

−20

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked @openai/codex-cli against OSV.dev.

Inventory

Tools (2)

Click any tool to inspect its schema.

~184 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Codex Bridge safe to use?: Codex Bridge has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.
How do I install Codex Bridge?: Codex Bridge supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can Codex Bridge do?: Codex Bridge provides 2 tools: query, analyze_files. See the full tools list on the server page for descriptions and parameters.
What AI clients work with Codex Bridge?: Codex Bridge is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.
Is Codex Bridge actively maintained?: Codex Bridge is less actively maintained — last commit was 183 days ago. It has 108 GitHub stars.