Onyx MCP Server
by lupuletic
Onyx MCP Server connects any MCP-compatible AI tool — Claude Desktop, Cursor, Windsurf, VS Code — to your organization's Onyx knowledge base. Ask Claude to search your company's Confluence, Google Drive, Slack, GitHub, Jira, and 40+ other data sources without leaving your editor. The server provides two core tools: search_onyx for semantic search across document sets with configurable context windows (chunks above and below matched content), and chat_with_onyx for RAG-powered Q&A with persistent chat sessions. Both tools respect your existing Onyx permissions and access controls automatically. Onyx itself is an MIT-licensed open-source platform with 25,000+ GitHub stars. It handles the heavy lifting: 50+ data connectors, document ingestion, vector embeddings, and retrieval. The MCP server is the bridge that makes all of that knowledge accessible through any MCP client. For enterprise teams, this solves the "context switching" problem. Instead of opening Confluence, searching, copying text, and pasting into your AI tool, you type one prompt. The agent searches your entire knowledge base, retrieves relevant context, and uses it in its response. Internal documentation, past decisions, code reviews, Slack threads — all searchable through natural language. Setup requires a running Onyx instance (self-hosted via Docker/Kubernetes) and the MCP server configured with your Onyx API credentials. Install via Smithery: npx -y @smithery/cli install @lupuletic/onyx-mcp-server --client claude. The server is built in TypeScript with Node.js v16+ and ships under MIT license. Related: Notion AI | MCP Servers Guide 2026
Installation
Key Features
- ✓Semantic search across 40+ enterprise data sources (Confluence, Google Drive, Slack, GitHub, Jira)
- ✓RAG-powered Q&A with persistent chat sessions via chat_with_onyx tool
- ✓Configurable context windows with chunks above/below matched content
- ✓Automatic enforcement of existing Onyx permissions and access controls
- ✓Full document retrieval option for complete page content
- ✓Works with Claude Desktop, Cursor, Windsurf, VS Code, and any MCP-compatible client
Use Cases
- →Search company documentation from inside your AI coding editor
- →Ask Claude questions about internal Confluence pages and wikis
- →Retrieve context from past Slack conversations and GitHub discussions
- →Build AI-powered Q&A over enterprise knowledge bases
- →Enrich AI agent responses with organizational context and domain knowledge