@freddy-coach/cli
v0.1.0
Published
Freddy CLI — connect your health data to AI agents
Maintainers
Readme
@freddy-coach/cli
The freddy CLI — connect your health data to AI agents.
Freddy is a personal multi-wearable MCP server. This CLI lets a headless agent (or you) sign in, connect wearables, and query your health data without hand-rolling the OAuth device flow, token refresh, or MCP plumbing.
Install
npm i -g @freddy-coach/cli # or: npx @freddy-coach/cli <command>Usage
freddy login # device flow → tokens in ~/.freddy (0600)
freddy connect oura # prints a URL to open in your browser to link a wearable
freddy providers # list connectable wearables
freddy query --metrics hrv,sleep_duration --days 7
freddy metrics # list available metrics
freddy profile # your account + connections
freddy sync oura | freddy disconnect oura
freddy status | freddy logoutAdd --json to any command for machine-readable output.
Configuration
| Env var | Default | Purpose |
|---|---|---|
| FREDDY_BASE_URL | https://freddy.coach | API host (set for self-hosting) |
| FREDDY_CONFIG_DIR | ~/.freddy | where tokens are stored (0600) |
Scopes
login requests mcp account:read by default. Connecting a wearable needs
connections:write — run freddy login --scope "mcp account:read connections:write".
License
MIT © reThrive Labs LLC
