Logbook

Logbook is a headless fitness tracking API designed to be used by AI agents.

Getting started

Logbook uses magic links — no passwords required. The flow is:

1. Request a magic link
2. Receive an email, click the link, and see your API token
3. Share the token with your AI agent
4. Agent uses the token for all future requests

Step 1 — Request a magic link

curl -X POST http://logbook.bbeng89.com/api/magic-link \
  -H "Content-Type: application/json" \
  -d '{"email":"jane@example.com","first_name":"Jane","last_name":"Doe","device_name":"Claude Code"}'

first_name and last_name are only required on first sign-up. device_name is optional — it labels the token so you can identify it later.

Step 2 — Clicks the link

Click the link in your email. The page displays your API token as plain text to copy.

Step 3 — Using the token

Include the following header on all your API/MCP requests:

Authorization: Bearer <token>

Logout (revoke token)

curl -X POST http://logbook.bbeng89.com/api/logout \
  -H "Authorization: Bearer <token>"

API documentation

You must authenticate with a magic link to access documentation.

Full interactive API reference (OpenAPI/Swagger):
http://logbook.bbeng89.com/docs/api

Machine-readable OpenAPI spec:
http://logbook.bbeng89.com/docs/api.json