Install icuvisor

Install the icuvisor binary for local mode. Pick your platform below, then head to Connect to wire it into an AI client.

icuvisor itself is MIT-licensed and open source, free to install and use. Local mode does not require an icuvisor-hosted account, onboarding credit, subscription, or icuvisor SaaS quota. If your MCP client needs a public HTTPS endpoint instead of a local process, use hosted mode. Your AI client, model provider, download source, hosted connector, and intervals.icu account may still have their own terms or limits.

Quick install

The fastest path on Linux, macOS (without Homebrew), WSL, and CI is the shell installer:

curl -fsSL https://icuvisor.app/install.sh | sh

On native Windows / PowerShell:

iwr -useb https://icuvisor.app/install.ps1 | iex

Prefer Winget on Windows?

winget install --id RicardoCabral.icuvisor --exact

The installer detects your platform, downloads the matching release asset, verifies the SHA256 checksum (and the cosign signature when cosign is on your PATH), and installs the binary. Re-run the same command to upgrade in place. See installer integrity for signature verification details.

After installing, run icuvisor setup to store credentials safely and write non-secret defaults. If you maintain JSON config by hand or point a client at a config path, see the config file reference; if your MCP client uses environment variables, see the CLI environment variable reference.

Platform guides

Prefer a package manager or platform-specific installer package? Pick your platform: