Docs
Your log, in whatever agent you already use.
Physique keeps your food, workouts and weigh-ins in plain JSON behind a small authenticated API. Point Claude Code, Codex, Pi or any tool with a shell at it and ask real questions about your own data.
Why you'd do that
- Ask about your week without opening the app. "What did my protein average last week?" "When did I last bench 225?" "Compare this cut to last summer's." The agent reads the numbers you logged; nothing is copied by hand.
- Log from wherever you're already typing. With a write credential an agent can add a meal or a weigh-in from a chat, a Slack thread, or a script. Save still goes through the same revision check the app uses, so nothing gets clobbered.
- Own the data. Export every day and every saved food as JSON in one call. Build a spreadsheet, a dashboard, or a model. Physique is the record; what you do with the record is yours.
- Safe by default. Credentials are read-only unless you choose otherwise, expire, are shown once, and can be revoked in the app. The server keeps only a hash.
How it works
- In the app, open your account (the circle at the top right) and choose Agent access. Create a credential. Copy it now; it is never shown again.
- Put the credential somewhere your agent can read it safely: a password manager, an environment variable, a secrets file with tight permissions. Never paste it into a chat.
- Pick a route: the Claude Code skill, the MCP server (Claude Code, Codex, Claude Desktop, Cursor), the tiny Python CLI for Pi or anything with a shell, or the HTTP API directly.
Claude CodeInstall the skill, or add the MCP server. Two minutes.
CodexMCP server in
config.toml, or the CLI in the sandbox.
Pi and other agentsThe dependency-free CLI works anywhere Python runs.
HTTP APIRoutes, scopes, dates, pagination, writes and errors.
What an agent can see
| Scope | Grants | Default |
|---|---|---|
fitness:read | Days: weigh-ins, workouts, food items, notes, prep notes, steps. Export. | on |
nutrition:read | Saved foods and recipes, with provenance. | on |
photos:metadata | Photo names, dates, tags. Not the pixels. | on |
photos:content | A five-minute link to an original or thumbnail. | off |
fitness:write | Write a day (weight, workout, food items) with revision checks. | off |
photos:write | Upload, relabel or delete photos. | off |
A 403 is a boundary, not a bug. If an agent needs to write, create a second credential with the write scope rather than widening the read-only one.