Skip to main content
Every client runs the same command, npx -y @heliyos/mcp, with your API key in the HELIYOS_API_KEY environment variable. Replace YOUR_HELIYOS_API_KEY in the snippets with your key. You need Node.js 20 or later and a key from Settings → API keys (see Authentication).
Config files that hold the key in plain text are as sensitive as the key. Keep them out of shared folders and repositories. Where a client can read the key from your environment or a secret store, prefer that.

​
Claude Code

​
Codex

Give Codex a 120 second tool timeout so heliyos_ask can finish. See Tool timeout.

​
Cursor

​
VS Code

​
Claude Desktop

Custom connectors on claude.ai and in the Claude connector directory need a hosted MCP server with OAuth. Heliyos does not offer one yet, so use a local client for now.

​
Antigravity

​
Other clients

​
Check it works

Ask your agent: “Which Heliyos workspace am I connected to?” It should call heliyos_organization_get and answer with your workspace’s name. If it does not, see Troubleshooting.
Last modified on November 5, 2026