# Codex–Claude Council

> Codex–Claude Council is an MCP server for ai models and llm tooling. Runs ChatGPT through Codex and Claude on one question until they agree. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, macOS, Windows, Linux, self-hosted
- **Repository:** https://github.com/hamza-aziz-ai/codex-claude-council
- **MCP Registry name:** io.github.hamza-aziz-ai/codex-claude-council
- **Categories:** [AI models and LLM tooling](https://ai-powered.com/categories/ai-and-llm), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

Instead of asking one model, you ask two. Both answer without seeing each other, then swap replies point by point, stating what they accept and where they still disagree and ending with AGREE or DISAGREE. When they agree, one writes the final answer and the other checks it.

Both models can read your project and run read-only commands such as git log and git diff, and both can search the web. Each side can run through its own CLI on your plan, through its CLI with an API key, or straight through the API. Existing Claude Code and Codex sessions can join the discussion.

Runs take several minutes, so tools return within about 50 seconds with a job id and council_result is used to collect the answer. Entry points include Claude Code, Codex, Claude Desktop, the ChatGPT desktop app and a stdio server for other clients.

## Features

- **Two-model discussion:** Codex and Claude reply to each other until they agree.
- **Read-only project access:** They can read files and run read-only git commands.
- **Own plans or API keys:** Each side uses its CLI plan or an API key.
- **Join with a session:** An existing Claude Code or Codex session can take part.
- **Long-run jobs:** Poll council_result while the council keeps running.

## Good for

- Get a second opinion on a design choice
- Debate a migration plan between two models
- Check whether a framework upgrade is safe
- Make one model write the final answer

## Install

### Claude Code (Terminal)

```sh
claude mcp add codex-claude-council -- npx -y codex-claude-council
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "codex-claude-council": {
      "command": "npx",
      "args": [
        "-y",
        "codex-claude-council"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "codex-claude-council": {
      "command": "npx",
      "args": [
        "-y",
        "codex-claude-council"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "codex-claude-council": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "codex-claude-council"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "codex-claude-council": {
      "command": "npx",
      "args": [
        "-y",
        "codex-claude-council"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "codex-claude-council": {
      "command": "npx",
      "args": [
        "-y",
        "codex-claude-council"
      ]
    }
  }
}
```

## Tools

- `council_ask`: Both models answer, then reply to each other until they agree.
- `council_debate`: Returns the final answer plus both answers and every exchange.
- `council_ask_codex`: Ask Codex alone.
- `council_ask_claude`: Ask Claude alone.
- `council_join`: Let the current session take part in the discussion.
- `council_result`: Fetch the result of a running job.
- `council_cancel`: Stop a running job.

## FAQ

### Which tools exist?

council_ask, council_debate, council_ask_codex, council_ask_claude, council_join, council_result and council_cancel.

### Why does it take minutes?

Each exchange needs model calls, and all count against both plans or keys.

### Can the models edit my code?

No. The README says neither can change anything.

### Can I run it without the CLIs?

Yes, each side can use only an OpenAI or Anthropic API key.

### How do I add Codex–Claude Council to Claude Code?

Run this command in your terminal: claude mcp add codex-claude-council -- npx -y codex-claude-council

### What are the best alternatives to Codex–Claude Council?

The closest alternatives to Codex–Claude Council are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/codex-claude-council
