MCP Directory

How to add Owlex to Claude Desktop

Get a second opinion in Claude Code: query Codex, Gemini, OpenCode and more, with structured multi-model deliberation. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

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

Claude Desktop 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 Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
  2. 2Paste the Owlex config below under the top-level "mcpServers" key.
  3. 3Fill in any placeholder secrets (API keys, paths) in the snippet.
  4. 4Save the file, then fully quit and reopen Claude Desktop.
  5. 5Open a chat and confirm Owlex's tools appear under the 🔌 tools menu.

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 Claude Desktop

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 + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Owlex config there under the "mcpServers" key and restart the client.

Is Owlex safe to use with Claude Desktop?

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