New teams get free Claude credits for their trial. Learn more

How to Connect Claude to Databricks

June 12, 2026•Updated October 10, 2026•5 min read•Vivek Sah
How to Connect Claude to Databricks

Databricks is increasingly where companies land when they need one platform for data engineering, ML, and analytics. Connecting it to Claude is now straightforward: Databricks ships its own MCP server for Claude. As with every warehouse, the connection is the easy part. Making the answers right for a whole team is where the three options split.

Claude connected to a Databricks lakehouse

Your three options

Genie One MCP (native)DIY MCP serverContextflo
SetupAdmin enables it; each person signs in with OAuthMinutes per person; you host and secure the serverMinutes, once for the whole team
CostFree for users until Jan 31, 2027; warehouse compute and service principals still billedFree software; warehouse compute billedFree for one person, paid per seat after that; warehouse compute billed by Databricks
Data it reachesUnity Catalog tables, plus other databases through Lakehouse FederationWhatever one credential can seeDatabricks plus Postgres, BigQuery, Snowflake, Redshift, Google Sheets, and CSVs
Business contextGenie agents: up to 50 tables each (docs recommend five or fewer), each curated separately by a SQL-literate analystNone; Claude reads raw schemasGenerated from your schema, code, and docs; sharpens as your team saves corrections; saved queries
Access controlUnity Catalog, including row filters and column masksOnly what the credential allowsPer-person table access and a log of every query
Real downsideAssumes a data team to curate an agent per subject areaClaude guesses what your columns meanTable-level access, not row-level

Option 1: Genie One MCP (native)

Databricks' business-user product, Genie One, is now reachable from Claude through a managed MCP server. It is generally available and documented for both Claude and ChatGPT.[1] You add https://<workspace>/ai-gateway/mcp-services/system.ai.genie_one_mcp as a connector and sign in with OAuth; Databricks recommends on-behalf-of-user auth, so Unity Catalog permissions apply per person. If you set up the earlier beta endpoint, move off it: it is deprecated on October 31, 2026.[1]

Genie One answers through Genie Ontology, Databricks' governed context layer, and the curated scopes underneath it are Genie agents (renamed from Genie spaces in July 2026). Each agent holds up to 50 tables, though Databricks' own guidance is five or fewer for accuracy, and the docs expect an analyst who knows SQL to keep adding context as people use it.[2][3] Data outside Databricks is reachable through Lakehouse Federation, once someone sets up the connections in Unity Catalog.[4]

User usage is free through January 31, 2027. The SQL warehouse compute that runs the queries is billed the whole time, and so is service principal usage, which is how many API and MCP agents authenticate.[5]

It is the right pick if your data already lives in Unity Catalog and you have people whose job includes curating agents.

Option 2: A DIY MCP server

The other route is pointing a general-purpose MCP server, or Databricks' lower-level managed MCP endpoints,[6] at your workspace with a token. Claude can then list tables and run SQL.

Want this setup emailed to you?

We'll send the steps to your inbox so you have them handy.

  • No business context: Claude sees column names, not what they mean. "Revenue" still has to be defined somewhere.
  • Per-person setup: each team member configures their own connection, and nothing is managed centrally.
  • Access is the credential's: whoever's token it is, Claude sees what they see.

It works for a data engineer exploring a schema they already know.

Option 3: Databricks plus Claude through Contextflo

Contextflo connects to your Databricks workspace once, read-only, generates context for your tables, and serves it to Claude and ChatGPT over MCP. Your team asks in the AI they already use, with shared definitions and per-person table access, and Databricks can sit next to your other sources.

  1. Connect Databricks. In Contextflo, add a Databricks data source with your workspace URL and a service principal or personal access token that has read access.
  2. Sync your tables. Pick the catalogs, schemas, and tables to include. Contextflo generates descriptions for each table and column from Unity Catalog metadata, plus any code and docs you connect.
  3. Connect Claude. In Claude, add Contextflo as a connector with https://mcp.contextflo.com/mcp and sign in. Each teammate connects once and gets the same definitions.
  4. Ask your first question. For example: "What was net revenue last month, by region?" Claude writes the SQL, runs it on your warehouse, and shows the query and the definition it used.

Which to choose

Genie One MCP if you are all-in on Databricks and have a data team to curate agents. You get row-level governance from Unity Catalog and near-zero license cost until 2027.

A DIY MCP server for one technical person who knows the schema and wants raw access.

Contextflo if non-technical people need answers in Claude or ChatGPT, your data lives in more than one place, and nobody's job is curating a semantic layer.

Here is a more in-depth look at Contextflo and how it works.

What is Contextflo?

Contextflo is a governed context layer between your data and the AI your team already uses. Connect your warehouse once, and your team asks questions in their own Claude or ChatGPT. The model writes and runs the SQL; Contextflo supplies the definitions, the per-user access control, and the audit that make the answers trustworthy. Your data never moves, and you do not need a data team.

How it works

1
Connect your data
Point Contextflo at your warehouse or database, or upload a CSV. It reaches multiple sources at once, so a single question can span all of them.
2
Bootstrap your context layer and review
Connect your code repo, Notion docs, or a data dictionary, and Contextflo annotates each table in your data source where it can. You review and correct them. That becomes the foundational context layer: your AI agent does not just see tables, it sees the context around them.
3
Define metrics and save golden queries
Pin the verified SQL behind a metric once. Every question then resolves against the same definitions, so the number is consistent no matter who asks or how they phrase it.
A short walkthrough on a BigQuery warehouse.

Your team queries in their own Claude or ChatGPT over MCP, so you bring any agent rather than a locked-in bot, and every answer comes back with the SQL shown and access enforced per user.

FAQ

How do I connect Claude to Databricks? You connect Claude to Databricks through MCP. Databricks' own Genie One MCP server is the native route if your data is in Unity Catalog and someone curates Genie agents. A DIY MCP server gives Claude raw SQL access. Contextflo connects once for the whole team and adds business context and per-person table access, across Databricks and your other sources.

Is there a Databricks MCP server for Claude? Yes. Genie One MCP is generally available and documented for Claude and ChatGPT. You add the server URL https://<workspace>/ai-gateway/mcp-services/system.ai.genie_one_mcp and sign in with OAuth. The older beta endpoint is deprecated on October 31, 2026.

Is Genie One MCP free? User usage of Genie is free through January 31, 2027. The SQL warehouse compute that runs Genie's queries is still billed, and so is usage by service principals, which is how many API and MCP agents authenticate.

Can I use Claude in Databricks? Yes, two ways. Connect Claude to Genie One MCP to ask Databricks questions from Claude itself, or connect Claude through Contextflo, which serves your Databricks tables plus your other data sources with shared definitions and per-person access.