Connect Hex to Your AI Agent

Choose an existing project and supply the analysis inputs; follow its run status using the resulting run ID.

6 tools API key

Try a Hex Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Hex

Run a Published Analysis

Start a project with supplied variables and report whether its run completed or failed.

/oo Hex: Run Hex project [ID] with these input variables [values], do not update its published cached results, and check run [run ID] until it reaches a final status.

Start Working with Hex

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Hex

    Connect a Hex personal access token or workspace token.

    Connect Hex →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • A token with access to the target project and its published version.

Hex Tools

Hex provides project metadata and API-triggered run management. This connection starts the latest published version and reads run metadata; it does not retrieve notebook cell contents or analytical result tables.

Project Discovery

Find projects by owner, category, or collection and inspect their metadata.

Published Project Runs

Start published project runs, read API-run history and status, or cancel an in-progress run.

6 tools

List Projects

List Hex projects visible to the connected token, with pagination and common project filters.

hex.list_projects

Get Project

Get metadata for a single Hex project by project ID.

hex.get_project

Run Project

Trigger a run of the latest published version of a Hex project.

hex.run_project

List Project Runs

List API-triggered runs for a Hex project, optionally filtered by status.

hex.list_project_runs

Get Run Status

Get the status and metadata for a specific Hex project run.

hex.get_run_status

Cancel Run

Cancel an in-progress Hex project run.

hex.cancel_run

Frequently Asked Questions

Which project version runs?

The run action triggers the latest published version of the project. Unpublished edits are not the version it starts.

Can I validate inputs without execution?

Yes. Request a dry run to validate the supplied project inputs without executing the project.

What can I get after starting a run?

The response provides a run ID and available run links. Status queries report run state and metadata rather than the analysis’s cell outputs.

Connect Hex

About Hex ↗