Skip to content

Data & infrastructure integration

Hex MCP server for Claude, Codex and Cursor

Ask data questions and work with Hex projects. Connect the Hex MCP server to Toolstile once, then choose which of its tools Claude Code, Codex, Cursor and Claude Desktop may use.

Free plan available. Server credentials stay in Toolstile, not in agent configs.

On this page

What your AI apps can do with Hex

  • Search and run projects
  • Ask questions of your data

Hex MCP tools

18 tools, taken from the publisher's documentation on 29 October 2026. The server decides what it offers and can add or rename tools at any time; after you connect, Toolstile shows the current list.

ToolWhat it does
search_projectsSearch published and unpublished projects in the workspace
create_threadStart a new Thread conversation with the Hex Agent
get_threadGet a Thread's messages and results
continue_threadSend a follow-up prompt to a finished Thread
get_meGet the authenticated user, workspace and role
create_projectCreate a new empty project
get_projectGet one project's metadata
list_cellsList a project's draft cells
get_cellGet a single cell by ID
create_cellAdd a SQL, Python or Markdown cell
update_cellChange a cell's source
delete_cellRemove a cell from the draft
run_cellRun a cell and its upstream dependencies, with a dry-run option
run_notebookRun the whole draft project
get_runGet a run's status
get_cell_outputGet a SQL cell's latest output preview or error
get_cell_imageGet a PNG of an executed chart cell
list_data_connectionsList data connections

Suggested access for each AI app

The documentation this list comes from doesn't mark Hex's tools as read-only or destructive. Read each tool's description and decide per app before allowing it.

Coding agent in Claude Code or Cursor. Allow the read tools so the agent can look things up without stopping, and require approval for tools that change shared data.

Chat or research app in Claude Desktop. Allow reading and searching. Allow writes only where you want the app to act for you.

Unattended agent, such as a scheduled Codex job. No one is watching the session, so keep it narrow: allow what the job needs, require approval for changes and block the rest.

Blocked tools are removed from the tool list an app sees, so it won't try them. Because rules apply per app, the same Hex connection can be broad in one app and read-only in another, and the credential stays in Toolstile instead of each app's config file.

How it works with Toolstile

  1. Connect once. Add Hex to a workspace (browser sign-in). Toolstile keeps the credential, so no agent config holds it.
  2. Choose access per app. Give Claude Code every Hex tool, give Cursor only the read tools, or keep Hex away from an app entirely.
  3. Share approved accounts. Teammates use the connection without copying tokens, and you can remove access in one place.
  4. Review activity. See which app called which tool and when, so you can tighten access with evidence.

Add the Hex MCP server to an AI app

Through Toolstile, every AI app uses one gateway entry, whichever servers you connect. In Claude Code:

Shell
claude mcp add --transport http toolstile 'https://toolstile.com/mcp'

Then connect Hex in your workspace and choose which of its tools that app may use. Client setup covers Codex, Cursor and Claude Desktop.

To connect directly instead, add the Hex endpoint to each app separately. In Claude Code:

Shell
claude mcp add --transport http hex 'https://app.hex.tech/mcp'

In Cursor's mcp.json:

JSON
{
  "mcpServers": {
    "hex": {
      "url": "https://app.hex.tech/mcp"
    }
  }
}

Some servers accept only clients they have approved, or need a token header. Check the Hex MCP documentation for what your client needs.

Before you connect

A Hex account. Sign-in uses your Hex permissions.

Server details

DetailValue
PublisherHex
Endpointhttps://app.hex.tech/mcp
AuthenticationBrowser sign-in
CategoriesData & infrastructure
Tool list18 tools, observed 29 October 2026 (docs)

Hex MCP documentation