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
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-mcpWhat 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-mcpReplace <…> with your own values
Platform CLI
codex mcp add heliyos --env HELIYOS_API_KEY=<HELIYOS_API_KEY> --env HELIYOS_BASE_URL=<HELIYOS_BASE_URL> --env HELIYOS_MCP_EXPERIMENTAL=<HELIYOS_MCP_EXPERIMENTAL> -- npx -y @heliyos/heliyos-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"heliyos": {
"command": "npx",
"args": [
"-y",
"@heliyos/heliyos-mcp"
],
"env": {
"HELIYOS_API_KEY": "<HELIYOS_API_KEY>",
"HELIYOS_BASE_URL": "<HELIYOS_BASE_URL>",
"HELIYOS_MCP_EXPERIMENTAL": "<HELIYOS_MCP_EXPERIMENTAL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"heliyos": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@heliyos/heliyos-mcp"
],
"env": {
"HELIYOS_API_KEY": "<HELIYOS_API_KEY>",
"HELIYOS_BASE_URL": "<HELIYOS_BASE_URL>",
"HELIYOS_MCP_EXPERIMENTAL": "<HELIYOS_MCP_EXPERIMENTAL>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e HELIYOS_API_KEY=<HELIYOS_API_KEY> -e HELIYOS_BASE_URL=<HELIYOS_BASE_URL> -e HELIYOS_MCP_EXPERIMENTAL=<HELIYOS_MCP_EXPERIMENTAL> heliyos npx -y @heliyos/heliyos-mcpReplace <…> 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.