Add the Heliyos MCP server to Claude Code, Codex, Cursor or VS Code in a minute.
Every client runs the same command, npx -y @heliyos/mcp, with your key in the HELIYOS_API_KEY environment variable. Replace YOUR_HELIYOS_API_KEY in the snippets with your key.
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.
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.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Heliyos","description":"Developer docs for Heliyos, the AI operating system for revenue. Build on its unified customer memory and AI workers with the REST API and the MCP server.","colors":{"primary":"#27251E","light":"#FFD037","dark":"#27251E"},"logo":{"light":"https://mintcdn.com/heliyos/j131RqihzUCqTT55/logo/light.png?fit=max\u0026auto=format\u0026n=j131RqihzUCqTT55\u0026q=85\u0026s=b4ac5cbb6af42223e13e9abe4295155d","dark":"https://mintcdn.com/heliyos/j131RqihzUCqTT55/logo/dark.png?fit=max\u0026auto=format\u0026n=j131RqihzUCqTT55\u0026q=85\u0026s=e6755b09abefd37df8199b6a504a8a54","href":"https://www.heliyos.ai"},"favicon":"https://mintcdn.com/heliyos/j131RqihzUCqTT55/favicon.png?fit=max\u0026auto=format\u0026n=j131RqihzUCqTT55\u0026q=85\u0026s=13f98b158bbf66355eb23e7f3b0468a1","api":{"params":{"expanded":"closed"},"playground":{"display":"interactive"},"examples":{"defaults":"all","languages":["curl","javascript","python"]}},"appearance":{"default":"system","strict":false},"background":{"color":{"light":"#FAF7F3","dark":"#1E1C17"}},"navbar":{"links":[{"icon":"brand-github","href":"https://github.com/heliyos-ai","label":"GitHub"},{"icon":"brand-linkedin","href":"https://www.linkedin.com/company/heliyos","label":"LinkedIn"}],"primary":{"type":"button","label":"Join waitlist","href":"https://www.heliyos.ai"}},"seo":{"metatags":{"og:site_name":"Heliyos","og:locale":"en_US","og:type":"website","og:image":"https://www.heliyos.ai/assets/social-preview-2026-10-28.jpeg","og:image:width":"1200","og:image:height":"630","og:image:alt":"Heliyos: The AI operating system for revenue","twitter:card":"summary_large_image","twitter:image":"https://www.heliyos.ai/assets/social-preview-2026-10-28.jpeg","twitter:image:alt":"Heliyos: The AI operating system for revenue","keywords":"Heliyos API, Heliyos MCP server, AI operating system for revenue, AI workers, customer memory, CRM API, MCP server for sales","canonical":"https://docs.heliyos.ai"},"organization":{"id":"https://www.heliyos.ai/#organization","name":"Heliyos","url":"https://www.heliyos.ai","logo":"https://www.heliyos.ai/assets/brand/logo-color.png","sameAs":["https://www.heliyos.ai","https://www.linkedin.com/company/heliyos","https://github.com/heliyos-ai","https://www.npmjs.com/package/@heliyos/mcp"]},"indexing":"navigable"},"fonts":{"family":"Geist","source":"fonts/Geist-Variable.woff2","format":"woff2"},"icons":{"library":"tabler"},"styling":{"eyebrows":"section","codeblocks":"dark","latex":false},"contextual":{"options":["copy","view","chatgpt","claude","cursor","vscode"],"display":"header"},"thumbnails":{"preset":"headline","appearance":"light","surface":"neutral"},"metadata":{"timestamp":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"heliyos","hasAudioNarration":false,"actualSubdomain":"heliyos","customDomains":["docs.heliyos.ai"],"gitSource":{"type":"github","owner":"heliyos-ai","repo":"heliyos-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":"","_id":"6aec32751dd5aac17d4d14c7"},"chroma":{"latestBuiltDeploymentHistoryId":"6aecaf0264441d6863c94524","collectionId":"5c85d994-5da1-4fb6-b1f0-7110b5fe061b","liveDeploymentHistoryId":"6aecaf0264441d6863c94524","schemaVersion":"v3"},"feedback":{"thumbs":true,"edits":false,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aecb2311f2bb168c88a68bb","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"API reference","count":78},{"language":"default","tag":"MCP server","count":22},{"language":"default","tag":"Tools","count":15},{"language":"default","tag":"Guides","count":14},{"language":"default","tag":"Workers and runs","count":10},{"language":"default","tag":"Scouts","count":9},{"language":"default","tag":"Get started","count":7},{"language":"default","tag":"Files","count":6},{"language":"default","tag":"Records","count":6},{"language":"default","tag":"Tasks","count":6}],"searchSettings":{"showContentSnippets":true,"fullPageSearch":true,"isFiltersEnabled":true}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@font-face{font-family:\"Gambetta\";src:url(\"/fonts/Gambetta-Regular.woff2\") format(\"woff2\");font-weight:400;font-style:normal;font-display:swap}@font-face{font-family:\"Gambetta\";src:url(\"/fonts/Gambetta-Italic.woff2\") format(\"woff2\");font-weight:400;font-style:italic;font-display:swap}@font-face{font-family:\"Geist\";src:url(\"/fonts/Geist-Variable.woff2\") format(\"woff2\");font-weight:100 900;font-style:normal;font-display:swap}@font-face{font-family:\"Geist Mono\";src:url(\"/fonts/GeistMono-Variable.woff2\") format(\"woff2\");font-weight:100 900;font-style:normal;font-display:swap}:root{--hy-canvas: #FAF7F3;--hy-surface: #FEFDFB;--hy-zone: #F3EEE6;--hy-line: #E1DCD3;--hy-line-strong: #D1CBC2;--hy-text: #27251E;--hy-text-body: #4A4742;--hy-text-muted: #6D6A64;--hy-code-bg: #27251E;--hy-code-line: #3A372F;--hy-sun: #FFD037;--hy-sun-soft: #FFE58F;--hy-sun-wash: #FBF1C7;--hy-sun-deep: #EBB427;--hy-sun-ink: #815C0A;--hy-ink: #14120F;--hy-icon-filter: none;--hy-get-bg: #E5F5E7;--hy-get-fg: #287C42;--hy-get-edge: #B6DDBD;--hy-post-bg: #E5F2FF;--hy-post-fg: #2D5277;--hy-post-edge: #BBD6F3;--hy-put-bg: #F4ECFE;--hy-put-fg: #594571;--hy-put-edge: #DACBEE;--hy-patch-bg: #FFECDC;--hy-patch-fg: #9C5313;--hy-patch-edge: #F6C6A0;--hy-del-bg: #FFEAE7;--hy-del-fg: #B8433A;--hy-del-edge: #F6C3BB;--hy-warn-bg: #FFECDC;--hy-warn-fg: #9C5313;--hy-warn-edge: #F6C6A0;--hy-ok-bg: #E5F5E7;--hy-ok-fg: #287C42;--hy-ok-edge: #B6DDBD;--hy-bad-bg: #FFEAE7;--hy-bad-fg: #B8433A;--hy-bad-edge: #F6C3BB}html.dark{--hy-canvas: #1E1C17;--hy-surface: #27251E;--hy-zone: #3A372F;--hy-line: #3A372F;--hy-line-strong: #4A4742;--hy-text: #F3EEE6;--hy-text-body: #EBE5DB;--hy-text-muted: #A9A49B;--hy-code-bg: #14120F;--hy-code-line: #3A372F;--hy-sun-ink: #FFE58F;--hy-icon-filter: invert(0.93) sepia(0.08);--hy-get-bg: rgba(60, 154, 88, 0.18);--hy-get-fg: #B6DDBD;--hy-get-edge: rgba(60, 154, 88, 0.45);--hy-post-bg: rgba(85, 138, 192, 0.2);--hy-post-fg: #BBD6F3;--hy-post-edge: rgba(85, 138, 192, 0.5);--hy-put-bg: rgba(148, 118, 183, 0.2);--hy-put-fg: #DACBEE;--hy-put-edge: rgba(148, 118, 183, 0.5);--hy-patch-bg: rgba(219, 125, 36, 0.18);--hy-patch-fg: #F6C6A0;--hy-patch-edge: rgba(219, 125, 36, 0.45);--hy-del-bg: rgba(208, 90, 79, 0.2);--hy-del-fg: #F6C3BB;--hy-del-edge: rgba(208, 90, 79, 0.5);--hy-warn-bg: rgba(219, 125, 36, 0.14);--hy-warn-fg: #F6C6A0;--hy-warn-edge: rgba(219, 125, 36, 0.4);--hy-ok-bg: rgba(60, 154, 88, 0.14);--hy-ok-fg: #B6DDBD;--hy-ok-edge: rgba(60, 154, 88, 0.4);--hy-bad-bg: rgba(208, 90, 79, 0.16);--hy-bad-fg: #F6C3BB;--hy-bad-edge: rgba(208, 90, 79, 0.45)}body,button,input,select,textarea{font-family:\"Geist\", system-ui, sans-serif}code,pre,kbd,.font-mono{font-family:\"Geist Mono\", ui-monospace, monospace!important}body{background:var(--hy-canvas)!important;color:var(--hy-text)}.prose{color:var(--hy-text-body)}.prose h1,.prose h2,.prose h3,.prose h4,.prose strong,#page-title{color:var(--hy-text)!important}.prose h2{letter-spacing:-0.01em}.prose a:not([class]){color:var(--hy-text);font-weight:500;text-decoration:underline;text-decoration-color:var(--hy-sun-deep);text-decoration-thickness:2px;text-underline-offset:3px;border-bottom:none}.prose a:not([class]):hover{text-decoration-color:var(--hy-text)}img[src^=\"/icons/\"]{filter:var(--hy-icon-filter)}.nav-tabs-item{color:var(--hy-text-muted)!important}.nav-tabs-item:hover{color:var(--hy-text)!important}.nav-tabs-item[data-active=\"true\"]{color:var(--hy-text)!important;font-weight:600}.nav-tabs-item [class*=\"bottom-0\"][class*=\"bg-primary\"]{background:var(--hy-sun-deep)!important;height:2px!important;border-radius:2px}#sidebar-content a{border-radius:8px;transition:background-color .12s ease}#sidebar-content a:not([aria-current=\"page\"]):hover{background:var(--hy-zone);color:var(--hy-text)!important}#sidebar-content a[aria-current=\"page\"]{background:var(--hy-sun-deep)!important;color:var(--hy-ink)!important;border-color:var(--hy-sun-deep)!important;font-weight:600;text-shadow:none!important}#sidebar-content a[aria-current=\"page\"] img[src^=\"/icons/\"]{filter:none}#sidebar-content a[aria-current=\"page\"] [class*=\"bg-[#\"]{background:var(--hy-ink)!important;color:var(--hy-sun)!important;box-shadow:none}[class*=\"bg-green-400/20\"]{background:var(--hy-get-bg)!important;color:var(--hy-get-fg)!important;box-shadow:inset 0 0 0 1px var(--hy-get-edge)}[class*=\"bg-blue-400/20\"]{background:var(--hy-post-bg)!important;color:var(--hy-post-fg)!important;box-shadow:inset 0 0 0 1px var(--hy-post-edge)}[class*=\"bg-purple-400/20\"],[class*=\"bg-yellow-400/20\"]{background:var(--hy-put-bg)!important;color:var(--hy-put-fg)!important;box-shadow:inset 0 0 0 1px var(--hy-put-edge)}[class*=\"bg-orange-400/20\"]{background:var(--hy-patch-bg)!important;color:var(--hy-patch-fg)!important;box-shadow:inset 0 0 0 1px var(--hy-patch-edge)}[class*=\"bg-red-400/20\"]{background:var(--hy-del-bg)!important;color:var(--hy-del-fg)!important;box-shadow:inset 0 0 0 1px var(--hy-del-edge)}.method-pill{letter-spacing:0.02em}.card{background:var(--hy-surface)!important;border-color:var(--hy-line)!important;border-radius:16px!important;box-shadow:none!important;transition:border-color .15s ease, box-shadow .15s ease}.card:hover{border-color:var(--hy-sun-deep)!important;box-shadow:0 8px 24px -8px rgba(39,37,30,.18), 0 2px 4px rgba(39,37,30,.05)!important}.card [class*=\"size-6\"]:has(>img){width:40px!important;height:40px!important;display:grid;place-items:center;background:var(--hy-sun-wash);border:1px solid var(--hy-sun-soft);border-radius:10px}html.dark .card [class*=\"size-6\"]:has(>img){background:rgba(255, 208, 55, 0.12);border-color:rgba(255, 208, 55, 0.3)}.card [class*=\"size-6\"]:has(>img) img{width:22px!important;height:22px!important}.card h2{color:var(--hy-text)!important}.prose :not(pre)>code{background:var(--hy-zone);border:1px solid var(--hy-line);border-radius:7px;padding:1px 6px;color:var(--hy-text);font-size:0.875em}.code-block,[class*=\"code-block\"]{background:var(--hy-code-bg)!important;border-color:var(--hy-code-line)!important;border-radius:12px!important}.prose table{border-color:var(--hy-line)}.prose thead th{background:var(--hy-zone);color:var(--hy-text-muted);font-family:\"Geist Mono\", ui-monospace, monospace;font-size:11px;font-weight:500;letter-spacing:0.04em;text-transform:uppercase}.prose td,.prose th{border-color:var(--hy-line)}.callout{border-radius:12px!important}.callout[data-callout-type=\"note\"],.callout[data-callout-type=\"info\"]{background:var(--hy-sun-wash)!important;border-color:var(--hy-sun-soft)!important;color:var(--hy-text)!important;box-shadow:inset 3px 0 0 var(--hy-sun-deep)}html.dark .callout[data-callout-type=\"note\"],html.dark .callout[data-callout-type=\"info\"]{background:rgba(255,208,55,0.10)!important;border-color:rgba(255,208,55,0.3)!important}.callout[data-callout-type=\"warning\"]{background:var(--hy-warn-bg)!important;border-color:var(--hy-warn-edge)!important;color:var(--hy-warn-fg)!important}.callout[data-callout-type=\"tip\"],.callout[data-callout-type=\"check\"]{background:var(--hy-ok-bg)!important;border-color:var(--hy-ok-edge)!important;color:var(--hy-ok-fg)!important}.callout[data-callout-type=\"danger\"]{background:var(--hy-bad-bg)!important;border-color:var(--hy-bad-edge)!important;color:var(--hy-bad-fg)!important}.callout *{color:inherit}.callout code{background:rgba(255,255,255,.55)!important}html.dark .callout code{background:rgba(0,0,0,.25)!important}.tryit-button{background:var(--hy-sun)!important;color:var(--hy-ink)!important;font-weight:600;border:1px solid var(--hy-sun-deep);border-radius:8px!important;box-shadow:inset 0 1px 0 rgba(255,255,255,.35), 0 1px 2px rgba(20,18,15,.28)}.tryit-button:hover{opacity:1!important;background:var(--hy-sun-deep)!important}.tryit-button svg,.tryit-button path{fill:var(--hy-ink)!important;color:var(--hy-ink)!important}#navbar ul>li:not(.navbar-link)>a{background:linear-gradient(180deg, #3A372F, #27251E);color:#F3EEE6!important;border:1px solid #14120F;border-radius:8px;padding:6px 12px;box-shadow:inset 0 1px 0 rgba(255,255,255,.16), 0 1px 2px rgba(20,18,15,.28)}#navbar ul>li:not(.navbar-link)>a *{color:inherit!important}html.dark #navbar ul>li:not(.navbar-link)>a{background:var(--hy-sun);color:var(--hy-ink)!important;border-color:var(--hy-sun-deep)}#navbar ul>li:not(.navbar-link)>a>span[class*=\"absolute\"]{background:transparent!important}a:focus-visible,button:focus-visible,[role=\"tab\"]:focus-visible{outline:none;box-shadow:0 0 0 2px var(--hy-canvas), 0 0 0 4px var(--hy-text)!important;border-radius:8px}body:has(.hy-hero) #header{display:none}.hy-hero{padding:8px 0 24px}.hy-eyebrow{display:inline-flex;align-items:center;gap:8px;font-family:\"Geist Mono\", ui-monospace, monospace;font-size:11px;font-weight:500;letter-spacing:0.05em;color:var(--hy-sun-ink);margin:0 0 16px;background:var(--hy-sun-wash);border:1px solid var(--hy-sun-soft);border-radius:999px;padding:4px 10px}html.dark .hy-eyebrow{background:rgba(255,208,55,0.12);border-color:rgba(255,208,55,0.3)}.hy-display{font-family:\"Gambetta\", Georgia, serif!important;font-weight:400!important;font-size:56px!important;line-height:1.05;letter-spacing:-0.02em;color:var(--hy-text)!important;margin:0 0 16px}.hy-display em{font-style:italic}.hy-lede{font-size:17px;line-height:1.6;color:var(--hy-text-body);max-width:720px;margin:0}@media (max-width: 640px){.hy-display{font-size:40px!important;line-height:1.1;letter-spacing:-0.015em}}@media (prefers-reduced-motion: reduce){*,*::before,*::after{animation:none!important;transition:none!important}}[class*=\"group/step-indicator\"]{background:var(--hy-sun)!important;color:var(--hy-ink)!important;box-shadow:inset 0 0 0 1px var(--hy-sun-deep)}.steps [class*=\"border-l\"],.steps [class*=\"w-px\"]{border-color:var(--hy-sun-soft)!important;background-color:var(--hy-sun-soft)}html.dark .steps [class*=\"border-l\"],html.dark .steps [class*=\"w-px\"]{border-color:rgba(255,208,55,0.3)!important;background-color:rgba(255,208,55,0.3)}#sidebar-content ul.sidebar-group>li>a{margin-left:22px}#sidebar-content .sidebar-group-header{color:var(--hy-text)!important;font-weight:600}.hy-picker{margin:24px 0;border:1px solid var(--hy-line);border-radius:16px;background:var(--hy-surface);overflow:hidden}.hy-picker-tabs{display:grid;grid-template-columns:repeat(auto-fit, minmax(150px, 1fr));border-bottom:1px solid var(--hy-line)}.hy-picker-tab{display:flex;align-items:center;gap:10px;padding:14px 16px;text-align:left;cursor:pointer;background:transparent;border:0;border-right:1px solid var(--hy-line);border-bottom:1px solid var(--hy-line);margin-bottom:-1px;box-shadow:inset 0 2px 0 transparent;transition:background-color .12s ease}.hy-picker-tab:hover{background:var(--hy-zone)}.hy-picker-tab.is-active{background:var(--hy-sun-wash);box-shadow:inset 0 2px 0 var(--hy-sun-deep)}html.dark .hy-picker-tab.is-active{background:rgba(255,208,55,0.12)}.hy-picker-logo{width:32px;height:32px;flex-shrink:0;display:grid;place-items:center;background:#FEFDFB;border:1px solid #E1DCD3;border-radius:8px}.hy-picker-logo img{width:18px;height:18px;filter:none!important}.hy-picker-label{display:flex;flex-direction:column;min-width:0}.hy-picker-name{font-size:14px;font-weight:600;color:var(--hy-text)}.hy-picker-hint{font-size:12px;color:var(--hy-text-muted)}.hy-picker-panel{padding:8px 20px 12px}.hy-picker-step{display:flex;gap:14px;padding:14px 0;border-top:1px solid var(--hy-line)}.hy-picker-step:first-child{border-top:0}.hy-picker-num{width:24px;height:24px;flex-shrink:0;border-radius:999px;display:grid;place-items:center;background:var(--hy-sun);color:var(--hy-ink);font-size:12px;font-weight:600;box-shadow:inset 0 0 0 1px var(--hy-sun-deep)}.hy-picker-body{flex:1;min-width:0}.hy-picker-title{margin:2px 0 4px;font-size:14px;font-weight:600;color:var(--hy-text)}.hy-picker-text{margin:0 0 8px;font-size:14px;line-height:1.5;color:var(--hy-text-body)}.hy-picker-code{position:relative}.hy-picker-code pre{margin:0;padding:14px 16px;overflow-x:auto;border-radius:10px;background:var(--hy-code-bg);color:#F3EEE6;font-size:12.5px;line-height:1.6}.hy-picker-code code{background:none!important;border:0!important;padding:0!important;color:inherit!important;white-space:pre}.hy-picker-copy{position:absolute;top:8px;right:8px;padding:3px 10px;border-radius:7px;cursor:pointer;font-size:12px;font-weight:500;color:#F3EEE6;background:#3A372F;border:1px solid #4A4742}.hy-picker-copy:hover{background:#45423A}.hy-picker-link{display:inline-flex;align-items:center;margin-top:2px;padding:6px 12px;border-radius:8px;background:var(--hy-sun);color:var(--hy-ink)!important;font-size:13px;font-weight:600;text-decoration:none!important;border:1px solid var(--hy-sun-deep)}.hy-picker-tabs{grid-template-columns:repeat(4, minmax(0, 1fr))}.hy-picker-tab:last-child:nth-child(4n+3){grid-column:span 2}.hy-picker-name{white-space:nowrap;overflow:hidden;text-overflow:ellipsis}@media (max-width: 640px){.hy-picker-tabs{grid-template-columns:repeat(2, minmax(0, 1fr))}.hy-picker-tab:last-child:nth-child(4n+3){grid-column:auto}}.hy-picker-name{white-space:normal;font-size:13.5px;line-height:1.25}.hy-picker-head{display:flex;justify-content:space-between;align-items:baseline;gap:16px;margin:24px 0 10px;font-size:14px;color:var(--hy-text-muted)}.hy-picker-head a{color:var(--hy-text)!important;font-weight:500;text-decoration:underline;text-decoration-color:var(--hy-sun-deep);text-decoration-thickness:2px;text-underline-offset:3px}.hy-picker-head+.hy-picker{margin-top:0}.hy-picker-tabs{grid-template-columns:repeat(4, minmax(0, 1fr))}.hy-picker-tab:last-child{border-right:0}.hy-client{margin:12px 0 20px}.hy-client-head{display:flex;align-items:center;gap:10px;padding:14px 20px;border-bottom:1px solid var(--hy-line);background:var(--hy-sun-wash);box-shadow:inset 0 2px 0 var(--hy-sun-deep)}html.dark .hy-client-head{background:rgba(255,208,55,0.10)}.hy-picker-code pre{padding-right:76px}#navbar a[href=\"https://github.com/heliyos-ai\"] .truncate,#navbar a[href*=\"linkedin.com/company/heliyos\"] .truncate{position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap}#navbar a[href=\"https://github.com/heliyos-ai\"],#navbar a[href*=\"linkedin.com/company/heliyos\"]{padding:6px;border-radius:8px}#navbar a[href=\"https://github.com/heliyos-ai\"]:hover,#navbar a[href*=\"linkedin.com/company/heliyos\"]:hover{background:var(--hy-zone)}#navbar a[href=\"https://github.com/heliyos-ai\"] svg,#navbar a[href*=\"linkedin.com/company/heliyos\"] svg{width:18px;height:18px}#navbar ul:has(>li.navbar-link){gap:2px;align-items:center}#navbar ul:has(>li.navbar-link)>li{margin:0!important}#navbar ul:has(>li.navbar-link)>li:not(.navbar-link){order:-1;margin-right:12px!important}#navbar li.navbar-link>a{padding:6px!important}#navbar li.navbar-link>a svg{width:22px!important;height:22px!important}"}],"page":{"pagePath":"mcp/install","slug":"/mcp/install","pageMetadata":{"title":"Install","description":"Add the Heliyos MCP server to Claude Code, Codex, Cursor or VS Code in a minute.","keywords":["install Heliyos MCP","Claude Code MCP","Codex MCP","Cursor MCP","VS Code MCP"],"href":"/mcp/install"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Add the Heliyos MCP server to Claude Code, Codex, Cursor or VS Code in a minute.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];const __snippet_CURSOR_LINK_6mu44=`https://cursor.com/install-mcp?name=heliyos\u0026config=eyJ0eXBlIjoic3RkaW8iLCJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBoZWxpeW9zL21jcCJdLCJlbnYiOnsiSEVMSVlPU19BUElfS0VZIjoiJHtlbnY6SEVMSVlPU19BUElfS0VZfSJ9fQ%3D%3D`;const __snippet_VSCODE_LINK_6mu44=`https://vscode.dev/redirect/mcp/install?name=heliyos\u0026inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22heliyos-api-key%22%2C%22description%22%3A%22Heliyos+API+key+%28Settings+%E2%86%92+API+keys%29%22%2C%22password%22%3Atrue%7D%5D\u0026config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40heliyos%2Fmcp%22%5D%2C%22env%22%3A%7B%22HELIYOS_API_KEY%22%3A%22%24%7Binput%3Aheliyos-api-key%7D%22%7D%7D`;const __snippet_MCP_CLIENTS_6mu44=[{id:`claude-code`,name:`Claude Code`,hint:`Run in terminal`,logo:`/logos/claude.svg`,steps:[{title:`Install the Heliyos plugin`,text:`It asks for your API key, keeps it in your system's secure credential store, and adds a skill that teaches Claude when to use which tool.`,code:`claude plugin marketplace add heliyos-ai/heliyos-mcp\nclaude plugin install heliyos@heliyos`},{title:`Or add only the MCP server`,text:`Replace YOUR_HELIYOS_API_KEY with your key.`,code:`claude mcp add --transport stdio --env HELIYOS_API_KEY=YOUR_HELIYOS_API_KEY --scope user heliyos -- npx -y @heliyos/mcp`},{title:`Verify`,text:`Run /mcp in a Claude Code session, or claude mcp list, and look for heliyos.`}]},{id:`claude-desktop`,name:`Claude Desktop`,hint:`Edit config`,logo:`/logos/claude.svg`,steps:[{title:`Open the config file`,text:`In Claude Desktop, open Settings → Developer → Edit Config.`},{title:`Add Heliyos to claude_desktop_config.json`,text:`This file holds the key in plain text, so keep it private.`,code:`{\n \"mcpServers\": {\n \"heliyos\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@heliyos/mcp\"],\n \"env\": {\n \"HELIYOS_API_KEY\": \"YOUR_HELIYOS_API_KEY\"\n }\n }\n }\n}`},{title:`Restart Claude Desktop`,text:`Heliyos appears in the tools menu of a new chat.`}]},{id:`codex`,name:`Codex`,hint:`Run in terminal`,logo:`/logos/openai.svg`,steps:[{title:`Add Heliyos to ~/.codex/config.toml`,text:`env_vars passes HELIYOS_API_KEY from the shell you start Codex in, so export it there, for example in ~/.zshrc.`,code:`[mcp_servers.heliyos]\ncommand = \"npx\"\nargs = [\"-y\", \"@heliyos/mcp\"]\nenv_vars = [\"HELIYOS_API_KEY\"]\nstartup_timeout_sec = 30\ntool_timeout_sec = 120`},{title:`Or use the CLI`,text:`Then add tool_timeout_sec = 120 to the table it writes.`,code:`codex mcp add heliyos --env HELIYOS_API_KEY=YOUR_HELIYOS_API_KEY -- npx -y @heliyos/mcp`}]},{id:`cursor`,name:`Cursor`,hint:`One-click install`,logo:`/logos/cursor.svg`,steps:[{title:`Add Heliyos to Cursor`,text:`Open the install link, then confirm in Cursor.`,link:{href:__snippet_CURSOR_LINK_6mu44,label:`Add to Cursor`}},{title:`Or edit ~/.cursor/mcp.json`,text:\"Cursor reads ${env:HELIYOS_API_KEY} from its own environment. Export the variable and start Cursor from that shell.\",code:`{\n \"mcpServers\": {\n \"heliyos\": {\n \"type\": \"stdio\",\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@heliyos/mcp\"],\n \"env\": {\n \"HELIYOS_API_KEY\": \"\\${env:HELIYOS_API_KEY}\"\n }\n }\n }\n}`}]},{id:`vscode`,name:`VS Code`,hint:`One-click install`,logo:`/logos/vscode.svg`,steps:[{title:`Install Heliyos in VS Code`,text:`VS Code asks for your key the first time the server starts and keeps it in its secret storage.`,link:{href:__snippet_VSCODE_LINK_6mu44,label:`Install in VS Code`}},{title:`Or add it to .vscode/mcp.json`,text:`Use the project file, or your user file from MCP: Open User Configuration.`,code:`{\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"heliyos-api-key\",\n \"description\": \"Heliyos API key\",\n \"password\": true\n }\n ],\n \"servers\": {\n \"heliyos\": {\n \"type\": \"stdio\",\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@heliyos/mcp\"],\n \"env\": {\n \"HELIYOS_API_KEY\": \"\\${input:heliyos-api-key}\"\n }\n }\n }\n}`}]},{id:`antigravity`,name:`Antigravity`,hint:`Edit config`,logo:`/logos/google.svg`,steps:[{title:`Open the raw MCP config`,text:`In the agent panel, open … → MCP Servers → Manage MCP Servers → View raw config, or edit ~/.gemini/config/mcp_config.json.`},{title:`Add Heliyos`,code:`{\n \"mcpServers\": {\n \"heliyos\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@heliyos/mcp\"],\n \"env\": {\n \"HELIYOS_API_KEY\": \"YOUR_HELIYOS_API_KEY\"\n }\n }\n }\n}`}]},{id:`other`,name:`Any client`,hint:`stdio`,logo:`/icons/terminal.svg`,steps:[{title:`Run the server over stdio`,text:`Point your client at this command with the key in its environment.`,code:`HELIYOS_API_KEY=YOUR_HELIYOS_API_KEY npx -y @heliyos/mcp`},{title:`Plugin manifests`,text:`The repository also ships Agent Plugins manifests (plugin.json and mcp.json). In the MCP Registry the server is listed as ai.heliyos/crm.`}]}];const __snippet_FEATURED_6mu44=[`claude-code`,`codex`,`cursor`,`vscode`];const __snippet_ClientSteps_6mu44=({client,copied,onCopy})=>{const _components={a:`a`,..._provideComponents()};return _jsx(`div`,{className:`hy-picker-panel`,children:client.steps.map((s,i)=>_jsxs(`div`,{className:`hy-picker-step`,children:[_jsx(`span`,{className:`hy-picker-num`,children:i+1}),_jsxs(`div`,{className:`hy-picker-body`,children:[_jsx(`p`,{className:`hy-picker-title`,children:s.title}),s.text?_jsx(`p`,{className:`hy-picker-text`,children:s.text}):null,s.code?_jsxs(`div`,{className:`hy-picker-code`,children:[_jsx(`pre`,{children:_jsx(`code`,{children:s.code})}),_jsx(`button`,{type:`button`,className:`hy-picker-copy`,onClick:()=>onCopy(client.id+i,s.code),children:copied===client.id+i?`Copied`:`Copy`})]}):null,s.link?_jsxs(_components.a,{className:`hy-picker-link`,href:s.link.href,target:`_blank`,rel:`noreferrer`,children:[s.link.label,` →`]}):null]})]},client.id+i))})};const __snippet_useCopy_6mu44=()=>{const[copied,setCopied]=useState(null);const onCopy=(key,text)=>{navigator.clipboard?.writeText(text).then(()=>{setCopied(key);setTimeout(()=>setCopied(null),1500)})};return[copied,onCopy]};const InstallPicker=()=>{const _components={a:`a`,..._provideComponents()};const clients=__snippet_MCP_CLIENTS_6mu44.filter(c=>__snippet_FEATURED_6mu44.includes(c.id));const[active,setActive]=useState(clients[0].id);const[copied,onCopy]=__snippet_useCopy_6mu44();const client=clients.find(c=>c.id===active);return _jsxs(`div`,{className:`not-prose`,children:[_jsxs(`div`,{className:`hy-picker-head`,children:[_jsx(`span`,{children:`Works with every MCP client. Pick yours.`}),_jsx(_components.a,{href:`/mcp/clients`,children:`See all install options →`})]}),_jsxs(`div`,{className:`hy-picker`,children:[_jsx(`div`,{className:`hy-picker-tabs`,role:`tablist`,\"aria-label\":`Choose your AI client`,children:clients.map(c=>_jsxs(`button`,{type:`button`,role:`tab`,\"aria-selected\":c.id===active,className:`hy-picker-tab`+(c.id===active?` is-active`:``),onClick:()=>setActive(c.id),children:[_jsx(`span`,{className:`hy-picker-logo`,children:_jsx(`img`,{src:c.logo,alt:``})}),_jsxs(`span`,{className:`hy-picker-label`,children:[_jsx(`span`,{className:`hy-picker-name`,children:c.name}),_jsx(`span`,{className:`hy-picker-hint`,children:c.hint})]})]},c.id))}),_jsx(__snippet_ClientSteps_6mu44,{client,copied,onCopy})]})]})};function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,p:`p`,..._provideComponents(),...props.components},{Heading,Warning,_MdxComponentBoundary}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);if(!_MdxComponentBoundary)_missingMdxReference(`_MdxComponentBoundary`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Every client runs the same command, `,_jsx(_components.code,{children:`npx -y @heliyos/mcp`}),`, with your key in the `,_jsx(_components.code,{children:`HELIYOS_API_KEY`}),` environment variable. Replace `,_jsx(_components.code,{children:`YOUR_HELIYOS_API_KEY`}),` in the snippets with your key.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`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.`})}),`\n`,_jsx(_MdxComponentBoundary,{name:`InstallPicker`,children:_jsx(InstallPicker,{})}),`\n`,_jsx(Heading,{level:`2`,id:`check-it-works`,children:`Check it works`}),`\n`,_jsxs(_components.p,{children:[`Ask your agent: `,_jsx(_components.em,{children:`“Which Heliyos workspace am I connected to?”`}),` It should call `,_jsx(_components.code,{children:`heliyos_organization_get`}),` and answer with your workspace’s name. If it does not, see `,_jsx(_components.a,{href:`/mcp/troubleshooting`,children:`Troubleshooting`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{__snippet_CURSOR_LINK_6mu44,__snippet_VSCODE_LINK_6mu44,__snippet_MCP_CLIENTS_6mu44,__snippet_FEATURED_6mu44,__snippet_ClientSteps_6mu44,__snippet_useCopy_6mu44,InstallPicker,default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Install","description":"Add the Heliyos MCP server to Claude Code, Codex, Cursor or VS Code in a minute.","keywords":["install Heliyos MCP","Claude Code MCP","Codex MCP","Cursor MCP","VS Code MCP"],"href":"/mcp/install"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[162,7460,"undefined;const __snippet_VSCODE_LINK_6mu44=undefined;const __snippet_MCP_CLIENTS_6mu44=undefined;const __snippet_FEATURED_6mu44=undefined;const __snippet_ClientSteps_6mu44=()=>null;const __snippet_useCopy_6mu44=()=>null;const InstallPicker=()=>null;function _"]]},"mdxExtracts":{"tableOfContents":[{"title":"Check it works","slug":"check-it-works","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"heliyos","siteName":"Heliyos","title":"Install - Heliyos","relatedPagesConfig":{"enabled":false,"limit":5,"mode":"automatic"},"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-05T15:14:23.777Z","gitLastModified":"2026-11-05T15:07:02.000Z","originalFileLocation":"mcp/install.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Add the Heliyos MCP server to Claude Code, Codex, Cursor or VS Code in a minute.\">\u003cmeta data-mint-head name=\"keywords\" content=\"Heliyos API, Heliyos MCP server, AI operating system for revenue, AI workers, customer memory, CRM API, MCP server for sales\">\u003cmeta data-mint-head name=\"application-name\" content=\"Heliyos\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/heliyos/VGWcHMG0dpBG1nWt/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/heliyos/VGWcHMG0dpBG1nWt/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/heliyos/VGWcHMG0dpBG1nWt/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/heliyos/VGWcHMG0dpBG1nWt/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/heliyos/VGWcHMG0dpBG1nWt/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/heliyos/VGWcHMG0dpBG1nWt/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/heliyos/VGWcHMG0dpBG1nWt/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/heliyos/VGWcHMG0dpBG1nWt/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/heliyos/VGWcHMG0dpBG1nWt/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Install - Heliyos\">\u003cmeta data-mint-head property=\"og:description\" content=\"Add the Heliyos MCP server to Claude Code, Codex, Cursor or VS Code in a minute.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Heliyos\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.heliyos.ai/mcp/install\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://www.heliyos.ai/assets/social-preview-2026-10-28.jpeg\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Install - Heliyos\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Add the Heliyos MCP server to Claude Code, Codex, Cursor or VS Code in a minute.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://www.heliyos.ai/assets/social-preview-2026-10-28.jpeg\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/heliyos/VGWcHMG0dpBG1nWt/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Heliyos\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#27251E\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"og:image:alt\" content=\"Heliyos: The AI operating system for revenue\">\u003cmeta data-mint-head name=\"twitter:image:alt\" content=\"Heliyos: The AI operating system for revenue\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.heliyos.ai/mcp/install\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/mcp/install.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.heliyos.ai/#organization\",\"name\":\"Heliyos\",\"url\":\"https://www.heliyos.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://www.heliyos.ai/assets/brand/logo-color.png\"},\"sameAs\":[\"https://www.heliyos.ai\",\"https://www.linkedin.com/company/heliyos\",\"https://github.com/heliyos-ai\",\"https://www.npmjs.com/package/@heliyos/mcp\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.heliyos.ai#website\",\"name\":\"Heliyos\",\"url\":\"https://docs.heliyos.ai\",\"publisher\":{\"@id\":\"https://www.heliyos.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.heliyos.ai/mcp/install#webpage\",\"url\":\"https://docs.heliyos.ai/mcp/install\",\"name\":\"Install\",\"description\":\"Add the Heliyos MCP server to Claude Code, Codex, Cursor or VS Code in a minute.\",\"dateModified\":\"2026-11-05T15:07:02.000Z\",\"isPartOf\":{\"@id\":\"https://docs.heliyos.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.heliyos.ai/mcp/install#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.heliyos.ai/mcp/install#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Get started\",\"item\":\"https://docs.heliyos.ai/mcp/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Install\",\"item\":\"https://docs.heliyos.ai/mcp/install\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.heliyos.ai/mcp/install#article\",\"headline\":\"Install\",\"name\":\"Install\",\"description\":\"Add the Heliyos MCP server to Claude Code, Codex, Cursor or VS Code in a minute.\",\"url\":\"https://docs.heliyos.ai/mcp/install\",\"mainEntityOfPage\":{\"@id\":\"https://docs.heliyos.ai/mcp/install#webpage\"},\"image\":\"https://www.heliyos.ai/assets/social-preview-2026-10-28.jpeg\",\"dateModified\":\"2026-11-05T15:07:02.000Z\",\"keywords\":\"install Heliyos MCP, Claude Code MCP, Codex MCP, Cursor MCP, VS Code MCP\",\"publisher\":{\"@id\":\"https://www.heliyos.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.heliyos.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Heliyos\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Heliyos","nav":{"global":null,"tabs":[{"tab":"Guides","icon":"https://mintlify.s3.us-west-1.amazonaws.com/heliyos/icons/tab-guides.svg","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","icon":"https://mintlify.s3.us-west-1.amazonaws.com/heliyos/icons/tab-api.svg","pages":[{"title":"API reference","href":"/api-reference/introduction"}]},{"tab":"MCP server","icon":"https://mintlify.s3.us-west-1.amazonaws.com/heliyos/icons/tab-mcp.svg","groups":[{"group":"Get started","icon":"https://mintlify.s3.us-west-1.amazonaws.com/heliyos/icons/tab-mcp.svg","pages":[{"title":"Heliyos MCP server","sidebarTitle":"Overview","description":"Give Claude, Cursor, Codex, VS Code and other AI agents safe, scoped access to your Heliyos workspace.","href":"/mcp/overview"},{"title":"Install","href":"/mcp/install"},{"title":"All install options","description":"Install the Heliyos MCP server in Claude Code, Codex, Cursor, VS Code, Claude Desktop, Antigravity or any MCP client.","href":"/mcp/clients"},{"title":"Configuration","href":"/mcp/configuration"}]},{"group":"Tools","icon":"https://mintlify.s3.us-west-1.amazonaws.com/heliyos/icons/group-tools.svg","pages":[{"title":"Tool reference","sidebarTitle":"All tools","icon":"https://mintlify.s3.us-west-1.amazonaws.com/heliyos/icons/layers.svg","href":"/mcp/tools/index"},{"title":"Records","sidebarTitle":"Records","icon":"https://mintlify.s3.us-west-1.amazonaws.com/heliyos/icons/app-company.svg","href":"/mcp/tools/records"},{"title":"Timeline and activity","sidebarTitle":"Timeline and activity","icon":"https://mintlify.s3.us-west-1.amazonaws.com/heliyos/icons/app-history.svg","href":"/mcp/tools/timeline-and-activity"},{"title":"Workspace, objects and fields","sidebarTitle":"Workspace, objects and fields","icon":"https://mintlify.s3.us-west-1.amazonaws.com/heliyos/icons/app-objects.svg","href":"/mcp/tools/workspace-objects-and-fields"},{"title":"Notes","sidebarTitle":"Notes","icon":"https://mintlify.s3.us-west-1.amazonaws.com/heliyos/icons/app-notes.svg","href":"/mcp/tools/notes"},{"title":"Tasks","sidebarTitle":"Tasks","icon":"https://mintlify.s3.us-west-1.amazonaws.com/heliyos/icons/app-tasks.svg","href":"/mcp/tools/tasks"},{"title":"Scouts and signals","sidebarTitle":"Scouts and signals","icon":"https://mintlify.s3.us-west-1.amazonaws.com/heliyos/icons/app-scouts.svg","href":"/mcp/tools/scouts-and-signals"},{"title":"Ask, runs and reviews","sidebarTitle":"Ask, runs and reviews","icon":"https://mintlify.s3.us-west-1.amazonaws.com/heliyos/icons/app-chat.svg","href":"/mcp/tools/ask-runs-and-reviews"},{"title":"Workers, triggers and tools","sidebarTitle":"Workers, triggers and tools","icon":"https://mintlify.s3.us-west-1.amazonaws.com/heliyos/icons/app-workers.svg","href":"/mcp/tools/workers-triggers-and-tools"},{"title":"Knowledge base and files","sidebarTitle":"Knowledge base and files","icon":"https://mintlify.s3.us-west-1.amazonaws.com/heliyos/icons/app-knowledge.svg","href":"/mcp/tools/knowledge-base-and-files"},{"title":"Watchlist","sidebarTitle":"Watchlist","icon":"https://mintlify.s3.us-west-1.amazonaws.com/heliyos/icons/app-watchlist.svg","href":"/mcp/tools/watchlist"},{"title":"Labels","sidebarTitle":"Labels","icon":"https://mintlify.s3.us-west-1.amazonaws.com/heliyos/icons/app-labels.svg","href":"/mcp/tools/labels"},{"title":"Team","sidebarTitle":"Team","icon":"https://mintlify.s3.us-west-1.amazonaws.com/heliyos/icons/app-teams.svg","href":"/mcp/tools/team"},{"title":"Notification settings","sidebarTitle":"Notification settings","icon":"https://mintlify.s3.us-west-1.amazonaws.com/heliyos/icons/app-preferences.svg","href":"/mcp/tools/notification-settings"},{"title":"Usage","sidebarTitle":"Usage","icon":"https://mintlify.s3.us-west-1.amazonaws.com/heliyos/icons/app-usage.svg","href":"/mcp/tools/usage"}]},{"group":"Operate","icon":"https://mintlify.s3.us-west-1.amazonaws.com/heliyos/icons/group-operate.svg","pages":[{"title":"Prompts and resources","href":"/mcp/prompts-and-resources"},{"title":"Security","href":"/mcp/security"},{"title":"Troubleshooting","href":"/mcp/troubleshooting"}]}]},{"tab":"Changelog","icon":"https://mintlify.s3.us-west-1.amazonaws.com/heliyos/icons/app-history.svg","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Install - Heliyos","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":[],"chunks":[]}