Integrations
Gravl MCP
The Gravl MCP server lets AI assistants act on your account through the Model Context Protocol — log a workout by describing it, tweak your split mid-conversation, ask what you benched last month. Scopes are enforced on every call, and the connection is revocable any time.
Connect
Add Gravl as a custom connector in any MCP-capable client:
https://mcp.gravl.ai/mcp- Claude — Settings → Connectors → “Add custom connector”, paste the URL, then complete the sign-in when prompted.
- Other clients — any client supporting remote MCP servers with OAuth works the same way.
Sign in with the same email as your Gravl account. The connection links to your existing account — it never creates one — and your email must be verified. The assistant only ever sees your own data.
What it can do
Log & manage workouts
Create, read and delete workouts — logged workouts get volume, calories, PRs and trophies exactly like the app.
Templates & splits
Create and edit workout templates and custom training splits from a conversation.
Settings & account
Read and update workout, warmup, rest-time and appearance settings on your account.
Browse the catalog
Search exercises and equipment, check personal records and body measurements.
Workouts logged through MCP are first-class: they get volume and calorie calculations, personal records, trophies and feed entries exactly as if logged in the app, and the app picks them up on its next sync.
Security model
| Layer | What it does |
|---|---|
| OAuth sign-in | The MCP server verifies your identity before any tool runs; your Gravl credentials are never shared with the AI client. |
| Per-connection scopes | Each connection carries an explicit scope set; every tool call is checked against it server-side. |
| Account linking | Connections attach to existing accounts by verified email only. |
| Revocation | Disconnect from your MCP client, or revoke the connection from your Gravl account — either kills access immediately. |
MCP or the REST API?
| You’re building… | Use |
|---|---|
| An AI assistant experience (chat, agents) on your own account | MCP |
| A dashboard, script or integration reading your data | A personal token + REST API |
| An app other Gravl users sign in to | OAuth + REST API |