Skip to main content
MCP server CX Codex

Heliyos — Claude Code MCP server: features and setup

This MCP server for Claude Code connects an AI agent to a Heliyos workspace. Agents can work with CRM records, tasks and notes, and start Heliyos workers.

MIT updated 2026-11-06

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add --env HELIYOS_API_KEY=<HELIYOS_API_KEY> --env HELIYOS_BASE_URL=<HELIYOS_BASE_URL> --env HELIYOS_MCP_EXPERIMENTAL=<HELIYOS_MCP_EXPERIMENTAL> --transport stdio heliyos -- npx -y @heliyos/heliyos-mcp
Open on GitHub

What Heliyos does

Heliyos connects an AI agent to its CRM and workspace through the API. The agent can find and edit companies, people and deals, inspect record histories, and create tasks or notes. It can also manage scouts and the knowledge base, then use heliyos_ask to hand a job to Heliyos and track its run.

The server runs locally over stdio, launched with npx. It requires Node.js 20 or later and a Heliyos workspace API key supplied as HELIYOS_API_KEY. Important actions by workers wait for review in Heliyos. Each key has admin access to one workspace.

What it helps with

  • find and update a company, contact or deal in the CRM
  • check a record’s change history and meetings
  • create a Heliyos task or note
  • send a job to a Heliyos worker and track its run
  • review scout signals and maintain the watchlist

Example prompts for the agent

  • Find the Acme deal in Heliyos and update its status.
  • Create a Heliyos task from the notes for my latest meeting with Acme.
  • Ask Heliyos to check new scout signals and show the run status.

How to install Heliyos

Platform CLI

claude mcp add --env HELIYOS_API_KEY=<HELIYOS_API_KEY> --env HELIYOS_BASE_URL=<HELIYOS_BASE_URL> --env HELIYOS_MCP_EXPERIMENTAL=<HELIYOS_MCP_EXPERIMENTAL> --transport stdio heliyos -- npx -y @heliyos/heliyos-mcp

Replace <…> with your own values

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about Heliyos

How do I install Heliyos in Claude Code?

Run claude mcp add heliyos-mcp -e HELIYOS_API_KEY=<HELIYOS_API_KEY> -- npx -y @heliyos/heliyos-mcp. Replace <HELIYOS_API_KEY> with your Heliyos API key.

What does Heliyos do?

It gives an agent access to Heliyos CRM records, tasks and notes, with tools for working with AI workers and scouts.

What does Heliyos need to run?

It requires Node.js 20 or later and a Heliyos workspace API key. The server starts through npx.

Similar MCP servers

MCP servers catalog →

Project sponsors

Companies that keep this analytics open