Hex MCP Plugin

June 22, 2026 ยท View on GitHub

Connect Cursor to your Hex workspace through the Model Context Protocol (MCP).

Note: Hex MCP Server is currently in beta and requires a Hex Team or Enterprise plan.

Installation

Install this plugin from the Cursor Marketplace. After installation, you'll be prompted to authenticate with your Hex account via OAuth.

Tip: For single tenant, EU multi-tenant, or HIPAA customers, you may need to configure a custom Hex URL (e.g., your-company.hex.tech/mcp, eu.hex.tech/mcp, hc.hex.tech/mcp).

What This Plugin Provides

This plugin adds Hex MCP tools and agent skills to Cursor.

MCP Tools

ToolDescription
search_projectsFind projects in your Hex workspace
create_threadStart a new Thread conversation to ask data questions
get_threadRetrieve messages and results from a Thread
continue_threadAdd follow-up questions to an existing Thread

Skills

SkillDescription
hex-business-analytics-questionSearches existing Hex projects and uses Hex Agent threads when needed to answer business analytics questions.
hex-notebook-authoringGuides local-first Hex notebook and project authoring through the Hex CLI.
hex-to-canvasPrompts Hex Threads for exact, source-backed KPI values and uses them to build a Cursor canvas with clear citations and caveats.

Usage Examples

Search for Projects

Do we have any projects about customer segmentation?

Returns project titles, descriptions, summaries, and direct links.

Ask Data Questions

What were our top-selling products last quarter?

Creates a Thread that analyzes your data and returns insights, charts, and a link to view the full analysis in Hex.

Follow-up Questions

Can you break that down by sales channel?

Continues the existing Thread conversation.

Build a Canvas from Hex Metrics

Use Hex to pull the latest activation KPIs from our onboarding dashboard and build a canvas that compares them with this branch's recent product changes.

Uses the hex-to-canvas skill to request exact values, periods, rate denominators, source tables, and caveats from Hex before creating a Cursor canvas.

Requirements

  • Hex Plan: Team or Enterprise
  • Workspace Role: Explorer or higher (for create_thread and continue_thread)
  • Data Connection: A default data connection must be configured in your Hex workspace

Limitations

  • Only text-based prompts are supported (no file uploads)
  • Threads typically take several minutes to complete

Future Improvements

We are looking to expand our plugin offering, if you have any ideas or feedback, please let us know by emailing support@hex.tech.

Resources