MinusX Documentation
Welcome to MinusX — the open-source agentic BI tool

MinusX is an open-source, AI-native business intelligence tool that helps companies organize their data and put agents to work. It is Claude Code / Codex for serious data work. MinusX combines three core components of the data stack:
- One Place for All Your Data — connect all your data sources, create trusted datasets and metrics that everyone in the org can rely on
- AI-Assisted Self-Service BI — explore data in natural language, build questions and dashboards with an agent that understands your context
- Proactive Analytics — scheduled reports, threshold-based alerts — understand what to focus on and find out what's broken
A trainable, trustworthy agent lives across the entire product surface, assisting in all the above workflows.

Who is MinusX for?
Whether you're a founder with a Supabase instance or a data team supporting hundreds of stakeholders, MinusX scales with you. Different parts of MinusX become important at different scales.
Simple data, few sources
Lots of diverse sources, complex analyses
Founder / Small team
Data team serving an org
Installation
Get started in ~5 minutes with self-hosted Docker, or ~2 minutes with managed cloud. Not sure which to pick? See our comparison guide →
Already using Metabase, Grafana, or Redash? We offer 1-day migration. Book a demo →
Self-Hosted
Run MinusX on your own infrastructure with Docker or from source
Cloud / Managed
Let us handle hosting and infrastructure for you
Philosophy
MinusX is built on a few core beliefs:
- Trust is paramount. Text-to-SQL is solved. Business users will never trust a 200-line-vibe-SQL snippet, and it is not useful to anyone.
- Analytics is primarily a modeling problem. Most serious companies recognize this. But modeling, the way it stands today, is too complex and more akin to medicine. Data modeling needs to be colocated with, and informed by the actual questions people are asking.
- Context is King. Context without Evals is hopium.
- BI as a file system. Agent harnesses need to get out of the way of state-of-the-art LLMs.
MinusX Agent
The MinusX agent lives on every page in MinusX. Whether you're exploring data, editing a question, or building a dashboard — the agent understands your current context and can take actions directly.
| Page | What can you do? | Examples |
|---|---|---|
| Explore | Go from question to insight in seconds | "What are the top 10 customers by revenue?" "Now filter to Q1" "Show it as a bar chart" |
| Questions | Build production-grade analyses without writing SQL from scratch | "Add a date filter" "Change the aggregation to AVG" "Make this a pivot table with region as rows" |
| Dashboards | Assemble a live view your team actually checks every morning | "Add a revenue chart" "Create a filter for region" "Move the KPI cards to the top" |
| Reports | Make the data come to people instead of the other way around | "Change the schedule to weekly" "Add the marketing team" |
| Alerts | Know when something breaks before your customers do | "Alert me when revenue drops below $10k" "Change to daily checks" |
| Slack | Let your whole team ask data questions where they already work | "@minusx what was revenue last week?" "@minusx top 5 churned accounts this month" |
| MCP | Give your AI coding tools direct access to your data | Search schemas, run queries, list connections — from Claude Desktop, Cursor, or Windsurf |
Core Concepts
BI: Questions & Dashboards
SQL queries, visualizations, and interactive dashboards
Sources & Data Models
Connect databases and model your data
Knowledge Base & Evals
Teach the AI about your data and measure accuracy
Proactive Analytics
Scheduled reports and threshold-based alerts
Integrations
MCP server for AI clients and Slack bot integration