Install icuvisor

icuvisor runs locally on your computer as a single binary. Install it first, then store your intervals.icu API key and connect an MCP client.

Choose your platform

Platform	Status	Start here
macOS	Signed DMG for the beta release line.	Install on macOS
Windows	Installer planned for v1.0.	Windows status
Linux	Packages planned for v1.0.	Linux status
Build from source	Developer/power-user path.	Build from source on GitHub

Run icuvisor setup to store your intervals.icu API key in the OS keychain and write non-secret configuration.
Run icuvisor version to confirm the binary starts.
Connect your AI client to the installed binary.

The exact command path depends on your platform. On macOS, MCP clients should execute:

/Applications/icuvisor.app/Contents/MacOS/icuvisor

For CLI flags and environment variables, see the CLI reference.