For Claude, ChatGPT, Claude Code and Cursor
A fitness MCP server your assistant can read and write
Connect revns to your AI assistant and it can see your brief, scores, trends, goals and week plan, and, if you allow it, log entries and meals, set goals and plan your days. Device connectors read what a watch recorded; this gives the assistant the objective, the plan and the log.
Streamable HTTP · OAuth 2.1 with PKCE · scopes read:fitness, write:fitness, read:news
Connect in a minute
26 tools
| Tool | Permission | Does |
|---|---|---|
| get_today | read | Brief, day score, pillar scores, what is logged and still open, meals and today's plan |
| get_day | read | The same view for any past date |
| get_trends | read | Daily values, means and previous-period comparison for chosen metrics |
| get_weekly_review | read | This week against last: score, consistency, best day, most missed |
| get_week_plan | read | The seven-day plan: sessions, effort, rest day, habits and protein anchors |
| get_rank | read | Your ranks for sleep, steps, training, heart rate and VO2 max against people your age, your sex or your kind of work, and what moves you up |
| compare_with_athlete | read | How you stack up against a typical footballer, cricketer, MMA fighter, F1 driver and more |
| list_metrics | read | Every tracked metric with its key, target, weight and cadence |
| find_activities | read | Search the master list of workouts and trackers, with calories at your weight |
| list_goals | read | Goals with pace, projection and status |
| list_teams | read | Teams and open invites |
| get_team_board | read | A team's shared scores, streaks and challenge standings |
| quick_log | write | Log from one line of text: "40 squats, slept 7h, lunch dal rice" |
| log_entries | write | Log values for one or more metrics |
| log_meal | write | Log a meal with On plan or Off plan and optional protein |
| create_metric | write | Start tracking anything new |
| update_metric | write | Change a target, weight, cadence or archive a metric |
| set_profile | write | Set up your whole profile in one call: objective, activities, trackers, weight, food, sex and kind of work |
| set_goal | write | Create a goal tied to a metric and date |
| update_goal | write | Change or close a goal |
| plan_day | write | Write the assistant's plan for a day |
| apply_week_plan | write | Write the seven-day plan into each day |
| save_coach_note | write | Write the morning brief or a weekly review |
| get_health_news | news | Recent health and fitness news |
| search | news | Search guides and news (OpenAI search contract) |
| fetch | news | Full text of a guide or story (OpenAI fetch contract) |
Things to ask
- “What should I do today, and why?”
- “I did 40 squats and 20 push-ups and slept 6 hours. Log it and plan a lighter tomorrow.”
- “Plan my week. I am vegetarian and eat eggs.”
- “Am I on pace for 74 kg by February? What should change?”
- “Write my morning brief for tomorrow.”
- “How did my sleep and gut log look over the last two weeks?”
Questions
What is a fitness MCP server?
An MCP (Model Context Protocol) server is a standard way for AI assistants to use outside tools and data. A fitness MCP server exposes your training data as tools, so an assistant such as Claude or ChatGPT can read your day and, with permission, write to it.
How do I connect my fitness data to Claude?
In Claude, open Settings, then Connectors, add a custom connector with https://mcp.revns.com/mcp, sign in and choose Allow. The step-by-step guide is on the Claude page.
Can the assistant change my data?
Only if you grant the write:fitness permission during sign-in. Tools that change data say so in their description, every write uses the same checks as the app, and each one is labelled with the assistant's name.
How is my data protected?
OAuth 2.1 with PKCE, one-hour access tokens, rotating refresh tokens that are revoked on reuse, per-user rate limits, and health data encrypted at rest with a per-user key. Disconnect any assistant from Coach at any time.
Which assistants work?
Any client that supports remote MCP servers over Streamable HTTP with OAuth, including Claude, ChatGPT, Claude Code and Cursor.
Create an account, then connect your assistant
The assistant signs in as you, with the permissions you choose.