physıque

Docs

Claude Code

Two ways in. The skill teaches Claude how to ask good questions of your log and ships a helper it runs itself. The MCP server exposes the same reads as tools. Use the skill if you talk to Claude Code in a terminal; add MCP if you also want it in Claude Desktop.

1. Get a credential

In the app: account circle → Agent access → Create read-only credential. Store it in your password manager, for example as Physique agent credential in Bitwarden.

2. Install the skill

mkdir -p ~/.claude/skills/physique ~/.config/physique
curl -fsSL https://physique.syncgr.com/agent/physique-skill.tar.gz | tar -xz -C ~/.claude/skills/physique
curl -fsSL https://physique.syncgr.com/agent/profile.example.json -o ~/.config/physique/profile.json
# edit credential_command to read your secret manager, e.g.
#   "credential_command": "bw get password 'Physique agent credential'"
~/.claude/skills/physique/scripts/physique discover

If discover prints your granted scopes and the date rules, you are done. Start a Claude Code session and ask: "what did I eat yesterday?" The skill triggers on questions about meals, macros, weigh-ins, workouts, saved foods and photos.

3. Or add the MCP server

curl -fsSL https://physique.syncgr.com/agent/physique_mcp.py -o ~/.config/physique/physique_mcp.py
claude mcp add physique -- python3 ~/.config/physique/physique_mcp.py

The server reads the same ~/.config/physique/profile.json. Override with PHYSIQUE_PROFILE or PHYSIQUE_TOKEN in the MCP env if you keep secrets elsewhere. Details on the MCP page.

What good prompts look like

  • "Average calories and protein for the last 14 days, and which days I was under 150g protein."
  • "List every session with overhead press this year and the top set each time."
  • "Pull my weigh-ins since August and tell me the weekly trend in lb per week."
  • "Export September to a CSV with date, calories, P, C, F, weight, steps."
Claude reads the smallest date range it needs and pages with cursor only when you ask for more. Absent nutrients mean unknown, not zero. Photo metadata is not the photo.

Writing from Claude Code

Create a second credential with fitness:write. The skill then handles put-day: it reads the day's current revision first, sends a unique requestId, and on a 409 shows you the live record instead of overwriting it. Say exactly what you want written: "log a weigh-in of 198.4 for today".