Connect Heystax to Claude Code (CLI)

Use your Stax and Next Actions directly from the terminal while coding with Claude Code.

Prerequisites

  • A Heystax account with Pro or Trial plan
  • Claude Code installed (install guide)

If you’ve already connected Heystax to Claude.ai (see Connect to Claude.ai), it automatically works in Claude Code too. The same connector is shared between both.

Verify

Open Claude Code in your terminal:

claude

Type /mcp to see connected servers. Heystax should appear as connected.

If it shows “needs authentication”, press Enter to re-authenticate in your browser.

Option 2: Add manually (global)

Add Heystax to all your Claude Code projects:

claude mcp add heystax \
  --transport sse \
  https://dash.heystax.ai/api/mcp/sse

You’ll be prompted to authenticate in your browser.

Verify 

claude

Then type /mcp — Heystax should show as connected.

Option 3: Add manually (per-project)

Add Heystax only to the current project:

claude mcp add heystax \
  --transport sse \
  --scope project \
  https://dash.heystax.ai/api/mcp/sse

This creates a .mcp.json file in your project root. Useful if you want different tokens or settings per project.

Usage examples

Once connected, just talk naturally:

> List my stax

> What are the next actions for my WebApp project?

> Add "fix the auth timeout bug" to WebApp

> Mark action 1 on WebApp as done

> Log that I deployed v2.3 to production on WebApp

Combining with Hey CLI

Heystax MCP and the Hey CLI complement each other:

Use case Best tool
Quick capture mid-flow hey "fix the bug"
Review and manage actions in conversation Claude Code MCP
Add actions while chatting with Claude Claude Code MCP
Bulk operations from terminal Hey CLI

Both write to the same Stax — changes sync in real time.

Troubleshooting

Problem Solution
“needs authentication” Press Enter to re-auth in browser
“PLAN_REQUIRED” Upgrade to Heystax Pro or Trial
Heystax not in /mcp list Run claude mcp add command above
“TOKEN_INVALID” Remove and re-add: claude mcp remove heystax then add again
Connection timeout Check your internet connection; the MCP server is at dash.heystax.ai

Remove

To disconnect Heystax from Claude Code:

claude mcp remove heystax

Or if using the claude.ai connector, disconnect from Claude.ai Settings > Integrations.

HeyStax Help © Hulupeep