# Heliyos

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: heliyos-ai
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/heliyos-ai/heliyos-mcp
- Updated: 2026-11-06
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/heliyos

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `HELIYOS_API_KEY`, `HELIYOS_BASE_URL`, `HELIYOS_MCP_EXPERIMENTAL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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

### Codex

**Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

## When to use it
- 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
- 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.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
