MCP Directory

How to add Owlex to Cursor

Get a second opinion in Claude Code: query Codex, Gemini, OpenCode and more, with structured multi-model deliberation. Paste the config into ~/.cursor/mcp.json and restart Cursor.

Last updated June 14, 2026 · 123★ · stdio · apikey

Cursor config for Owlex

uv tool install git+https://github.com/agentic-mcp-tools/owlex.git
{
  "mcpServers": {
    "owlex": {
      "command": "owlex-server",
      "args": []
    }
  }
}

Setup steps

  1. 1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
  2. 2Paste the Owlex config below into the "mcpServers" object.
  3. 3Fill in placeholder secrets, then save.
  4. 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
  5. 5Ask Cursor to use one of Owlex's tools to confirm it's connected.

Before you start

  • Python 3.10+
  • uv (for installation via `uv tool install`)
  • External agent CLIs as needed (Codex, Gemini, OpenCode, AiChat)
  • Existing subscriptions for Codex/Gemini, or API tokens for OpenCode/AiChat
  • OPENROUTER_API_KEY to enable the ClaudeOR agent

What Owlex can do in Cursor

council_ask

Run a structured council deliberation: agents answer independently, optionally revise or critique each other, and Claude synthesizes a final answer. Supports claude_opinion, deliberate, critique, roles, team, and timeout options.

start_codex_session

Start a new Codex session.

resume_codex_session

Resume a Codex session with a session ID or `--last`.

start_gemini_session

Start a new Gemini session.

resume_gemini_session

Resume a Gemini session with an index or `latest`.

start_opencode_session

Start a new OpenCode session.

resume_opencode_session

Resume an OpenCode session with a session ID or `--continue`.

start_claudeor_session

Start a new Claude-via-OpenRouter (ClaudeOR) session.

Security

Owlex orchestrates external AI CLIs/agents that can run with elevated permissions. `CODEX_BYPASS_APPROVALS=true` bypasses the Codex sandbox and `GEMINI_YOLO_MODE=true` auto-approves Gemini actions - use these with caution. `OPENCODE_AGENT` defaults to `plan` (read-only); set to `build` only when you want write access. Agents like ClaudeOR and AiChat require an `OPENROUTER_API_KEY` and incur API token costs.

Owlex + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Owlex config there under the "mcpServers" key and restart the client.

Is Owlex safe to use with Cursor?

Owlex orchestrates external AI CLIs/agents that can run with elevated permissions. `CODEX_BYPASS_APPROVALS=true` bypasses the Codex sandbox and `GEMINI_YOLO_MODE=true` auto-approves Gemini actions - use these with caution. `OPENCODE_AGENT` defaults to `plan` (read-only); set to `build` only when you want write access. Agents like ClaudeOR and AiChat require an `OPENROUTER_API_KEY` and incur API token costs.

How does the council deliberation work?

In Round 1 each agent answers your question independently without seeing others. In Round 2 each agent sees all Round 1 answers and can revise its position (or critique others, if critique mode is on). Finally Claude reviews everything and outputs a structured synthesized answer.

Which agents are supported?

Codex, Gemini, OpenCode, ClaudeOR (Claude via OpenRouter), and AiChat. You can exclude agents with the COUNCIL_EXCLUDE_AGENTS environment variable to control cost.

What are specialist roles and team presets?

Roles (security, perf, skeptic, architect, maintainer, dx, testing, neutral) shape how an agent analyzes a problem. You can assign them explicitly per-agent, auto-assign from a list, or use predefined team presets like security_audit, code_review, architecture_review, devil_advocate, balanced, and optimal.

View repo Full Owlex page