Onyx MCP Server

Name: Onyx MCP Server
Author: lupuletic

lupuletic

Get started Repository

Connects agents to an Onyx knowledge base for semantic search over documents and chat.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add onyx --env ONYX_API_TOKEN='<ONYX_API_TOKEN>' --env ONYX_API_URL='<ONYX_API_URL>' -- npx -y @smithery/cli install @lupuletic/onyx-mcp-server --client claude

~/.codex/config.toml

[mcp_servers.onyx]
command = "npx"
args = ["-y", "@smithery/cli", "install", "@lupuletic/onyx-mcp-server", "--client", "claude"]
env = { ONYX_API_TOKEN = "<ONYX_API_TOKEN>", ONYX_API_URL = "<ONYX_API_URL>" }

# codex mcp add onyx --env ONYX_API_TOKEN='<ONYX_API_TOKEN>' --env ONYX_API_URL='<ONYX_API_URL>' -- npx -y @smithery/cli install @lupuletic/onyx-mcp-server --client claude

~/.cursor/mcp.json

{
  "mcpServers": {
    "onyx": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@lupuletic/onyx-mcp-server",
        "--client",
        "claude"
      ],
      "env": {
        "ONYX_API_TOKEN": "<ONYX_API_TOKEN>",
        "ONYX_API_URL": "<ONYX_API_URL>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "onyx": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@lupuletic/onyx-mcp-server",
        "--client",
        "claude"
      ],
      "env": {
        "ONYX_API_TOKEN": "<ONYX_API_TOKEN>",
        "ONYX_API_URL": "<ONYX_API_URL>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "onyx": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@lupuletic/onyx-mcp-server",
        "--client",
        "claude"
      ],
      "env": {
        "ONYX_API_TOKEN": "<ONYX_API_TOKEN>",
        "ONYX_API_URL": "<ONYX_API_URL>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "onyx": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@lupuletic/onyx-mcp-server",
        "--client",
        "claude"
      ],
      "env": {
        "ONYX_API_TOKEN": "<ONYX_API_TOKEN>",
        "ONYX_API_URL": "<ONYX_API_URL>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "onyx": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@lupuletic/onyx-mcp-server",
        "--client",
        "claude"
      ],
      "env": {
        "ONYX_API_TOKEN": "<ONYX_API_TOKEN>",
        "ONYX_API_URL": "<ONYX_API_URL>"
      }
    }
  }
}

Environment variables

ONYX_API_TOKEN
ONYX_API_URL

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related