Hex MCP Server
Connect AI agents to Hex's collaborative data notebooks — query data and run Threads via natural language.
Updated
What is Hex MCP?
The Hex MCP server is a Model Context Protocol server that lets AI assistants interact directly with your Hex workspace — searching projects and running natural-language data questions through Hex's agentic Threads.
It is an official, Hex-hosted remote server reachable at https://app.hex.tech/mcp and authenticated over OAuth, so your AI client connects to your existing Hex workspace without a separate API key. Threads created through the MCP server behave like Threads in the Hex app: the agent automatically selects among the data connections the user has access to in order to answer a question, searching the workspace's default connection first.
The server is currently in beta and available on Hex's Team and Enterprise plans. Users need the Explorer workspace role or higher, and the server works with standard MCP clients including Claude Code, Claude Desktop, Cursor, and ChatGPT. Enterprise customers (single-tenant, EU, or HIPAA) replace app.hex.tech with their custom Hex URL.
Tools the Hex MCP server exposes
| Tool | What it does |
|---|---|
| search_projects | Find projects within your Hex workspace. |
| create_thread | Start a new agentic Thread to ask a data question in natural language. |
| get_thread | Retrieve the messages and results of an existing Thread. |
| continue_thread | Add a follow-up question to an existing Thread conversation. |
Connect the Hex MCP server
Claude Code
- 1
Add the server
Run: claude mcp add --transport http hex https://app.hex.tech/mcp
- 2
Authenticate
Run /mcp inside Claude Code, select hex, and complete the OAuth flow in your browser (choosing a workspace if you have more than one).
- 3
Use it
Ask data questions in natural language — Claude calls search_projects and the Thread tools against your Hex data connections.
Remote HTTP server with OAuth; requires a Hex Team/Enterprise plan and Explorer role.
Cursor
- 1
Open MCP settings
Go to Settings → Cursor Settings → Tools & MCP, or edit ~/.cursor/mcp.json directly.
- 2
Add Hex
Add a remote MCP server with URL https://app.hex.tech/mcp — e.g. {"mcpServers":{"hex":{"url":"https://app.hex.tech/mcp"}}}
- 3
Connect
Back in Settings, click Connect to start the OAuth flow and approve the connection (and pick a workspace if prompted).
Add as a remote MCP server URL; connect via OAuth.
Sample use cases
A scheduled agent asks Hex a recurring KPI question each morning via a Thread.
Daily metrics land in chat or email with no manual notebook runs.
An on-demand agent searches Hex projects to find the right analysis before answering a stakeholder question.
Faster discovery of existing work instead of rebuilding queries.
An event-triggered agent continues a Thread to drill into an anomaly when an alert fires.
Context-aware follow-up analysis against governed data connections.
Security & permissions
The Hex MCP server authenticates over OAuth — your AI client is redirected to Hex's authentication provider to approve the connection, and (for multi-workspace users) to choose a workspace. No long-lived API key is stored in the client.
The agent operates with the permissions of the connecting user: it can only reach the data connections that user already has access to in Hex, and a minimum Explorer workspace role is required. Access is scoped to searching projects and creating/reading/continuing Threads — the server answers text prompts only and cannot upload files. Enterprise customers can point the connection at a single-tenant, EU, or HIPAA-compliant Hex URL.
Using Hex MCP with Gamut
In a Gamut workflow, the Hex MCP server is wired in as a connected tool so an automated agent can pull answers from your governed data on a schedule or in response to an event — for example, a scheduled agent that opens a Thread to ask "what was yesterday's signup conversion?", reads the result, and posts a summary to Slack. Gamut manages the OAuth connection and credential lifecycle, and the agent only reaches the Hex projects and data connections the authorizing user can access. Because the server answers text prompts (it cannot ingest uploaded files), it suits read-and-report and data-Q&A steps rather than file-processing tasks.
Frequently asked questions
What is the Hex MCP server?
It is an official, Hex-hosted Model Context Protocol server at https://app.hex.tech/mcp that lets AI assistants like Claude Code and Cursor search your Hex projects and run natural-language data questions through Hex's agentic Threads, using your existing workspace data connections.
Is the Hex MCP server free?
The server itself has no separate fee, but it requires a Hex Team or Enterprise plan and an Explorer workspace role or higher. Hex has a free Community tier and a 14-day Team trial, though the MCP server (currently in beta) is only available on Team and Enterprise plans.
How do I connect Hex MCP to Claude Code or Cursor?
Both connect to the remote server at https://app.hex.tech/mcp over OAuth. In Claude Code, run `claude mcp add --transport http hex https://app.hex.tech/mcp` then authenticate via /mcp. In Cursor, add it as a remote MCP server URL under Tools & MCP (or in ~/.cursor/mcp.json) and click Connect to start the OAuth flow.
Is the Hex MCP server hosted or self-hosted?
It is hosted by Hex. You connect to the remote endpoint https://app.hex.tech/mcp (or your custom single-tenant, EU, or HIPAA URL) — there is no self-hosted version to run yourself.