Connect an AI client

After installing icuvisor, configure your AI client to start the local MCP server binary. Keep the intervals.icu API key out of client JSON; icuvisor reads it from the OS keychain or server environment.

Choose your client

macOS binary path

If you installed the macOS DMG, use this command in MCP client configuration:

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

If you built from source, use the absolute path to bin/icuvisor in your clone.

Non-secret configuration

Most stdio MCP clients use the same shape:

{
  "mcpServers": {
    "icuvisor": {
      "command": "/Applications/icuvisor.app/Contents/MacOS/icuvisor",
      "env": {
        "INTERVALS_ICU_ATHLETE_ID": "i12345",
        "ICUVISOR_TIMEZONE": "America/Sao_Paulo",
        "ICUVISOR_TRANSPORT": "stdio"
      }
    }
  }
}

The full list of flags and environment variables is in the CLI reference. For Streamable HTTP instead of stdio, see the HTTP transport guide.

• Connect ChatGPT
• Connect Claude Code
• Connect Claude Desktop
• Other MCP clients