Build agents on
real health data.
freddy is a personal MCP server for health and performance data. Sign a user up, connect their data sources, and query sleep, HRV, recovery, and workouts. All over the MCP standard, with an OAuth device flow built for headless clients and a one-command CLI.
npx @freddy-coach/cli loginOne server. Any agent.
Real health data over an open standard, with the auth and write tools a headless client needs.
Real data, 28+ sources
Polar, Oura, Garmin, WHOOP, Withings and more. The user's own accounts, never simulated.
The MCP standard
No proprietary API to learn. Any client that speaks MCP can read a user's data with one bearer token.
Device flow for headless
RFC 8628 device authorization plus dynamic client registration. No redirect_uri, no browser callback to wrangle.
Scoped, auditable write tools
Connect, disconnect, and sync data sources conversationally. Every call is scoped and lands in the user's audit log.
Health context turns agents
into coaches.
Three patterns people actually run. Each one is a scheduled agent, a freddy query, and a message back to you.
Morning briefing
A cron fires, the agent reads your night, and a message is waiting before your coffee.
HRV is 12% under your 7-day average and you only got 74 minutes of deep sleep. Take today easy; tomorrow looks good for intervals.
Trend watchdog
The agent tracks the slow signals you forget to check, and only speaks when something moves.
Your resting heart rate has crept up 4 bpm over two weeks while sleep stayed stable. Worth a look at training load.
Weekly report
A coach-style summary of the week across every source you have connected.
Training load up 18% on last week, sleep debt about an hour, HRV trending flat. One hard session fits before Thursday.
Give it something
worth running.
Recipes an agent can run on a schedule, from the public library. Wire one into a cron and let it report back.
to your agent“See which meetings spike your stress”
Line up your intraday stress with your calendar to find which meetings, and which people, wind you up.
to your agent“Why am I tired today?”
A one-prompt morning briefing that reads last night's sleep, HRV and resting heart rate and tells you how hard to push today, whatever ring or watch you wear.
to your agent“Does your bedroom air wreck your sleep?”
Line up your bedroom CO2, humidity and temperature with how well you slept, night after night, to find the environmental thing quietly costing you sleep.
Three commands.
The CLI wraps device-flow auth, token storage and refresh, the data-source connect handoff, and MCP calls.
npx @freddy-coach/cli login
npx @freddy-coach/cli connect oura
npx @freddy-coach/cli query --metrics hrv,sleep_duration --days 7No terminal? Any MCP client can drive freddy over raw HTTP: register a client, start the device flow, poll for a token, then call /mcp. See the headless setup guide.
Ask for exactly what you need.
The user approves scopes at sign-in. Omit scope and you get mcp only.
| Scope | Grants |
|---|---|
| mcp | MCP tool access: the read tools plus the three write tools. |
| account:read | Profile, plan and subscription, connections, OAuth grants, email prefs, sync status. |
| account:write | Rotate MCP token, email prefs, billing checkout/cancel, integration requests, chat. |
| connections:write | Connect, disconnect, and sync data sources. |
| audit:read | Audit log plus bulk health-data export. |
Read and write, conversationally.
All under the mcp scope. Queries plus three write tools for managing data sources.
| Tool | Purpose |
|---|---|
| get_profile | User metadata, connected data sources, plan. |
| list_metrics | Available metrics with counts, date ranges, units, and sources. |
| query_metrics | Fetch metrics by name and date range. |
| connect_source | Returns a verification URL for OAuth providers, or hands off to the freddy dashboard for API-key sources. |
| disconnect_source | Disconnects and wipes synced data. Destructive. |
| sync_source | Triggers an incremental sync. Fire-and-forget. |
| accept_terms | Records the user's acceptance of the current Terms and Privacy version. |
Everything you need to ship.
- Use the freddy CLI
- Connect from any AI agent
- Troubleshooting agent sign-in
- @freddy-coach/cli on npm
- llms.txt
- Building software instead of an agent? Personal API →