Arvo MCP Server - Fitness & Workout Tracker for Claude

1# Arvo MCP Server - Fitness & Workout Tracker for Claude
2 
3> **Fitness tracking MCP server** - Log gym sessions, track personal records (PRs), analyze body progress, and manage training splits through Claude Desktop, Cursor, and other MCP clients.
4 
5[![npm version](https://img.shields.io/npm/v/arvo-mcp.svg)](https://www.npmjs.com/package/arvo-mcp)
6[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
7[![MCP](https://img.shields.io/badge/MCP-Compatible-blue.svg)](https://modelcontextprotocol.io)
8 
9**arvo-mcp** is a Model Context Protocol (MCP) server that connects your AI assistant to [Arvo](https://arvo.guru), an AI-powered fitness coach. Access your **workout history**, **personal records**, **body composition**, and **training plans** directly from Claude Desktop, Cursor, or any MCP-compatible client.
10 
11Perfect for fitness enthusiasts who want to:
12- 🏋️ Ask "What's my workout today?" and get your personalized training plan
13- 📊 Track gym progress with AI-powered insights
14- 💪 Monitor PRs, volume, and muscle group distribution
15- 📈 Analyze body composition trends over time
16 
17## Features
18 
19- **29 fitness tools** - Profile, workouts, splits, PRs, body progress, and more
20- **Read & Write access** - View your data and make changes through natural conversation
21- **Secure API key authentication** - Your data stays private
22- **Works with any MCP client** - Claude Desktop, Cursor, Windsurf, and more
23 
24## Quick Start
25 
26### 1. Get your API key
27 
281. Sign up or log in at [arvo.guru](https://arvo.guru)
292. Go to **Settings** → **API Keys**
303. Click **Create Key** and copy your API key
31 
32### 2. Configure your MCP client
33 
34#### Claude Desktop
35 
36Add to your `claude_desktop_config.json`:
37 
38```json
39{
40  "mcpServers": {
41    "arvo": {
42      "command": "npx",
43      "args": ["-y", "arvo-mcp"],
44      "env": {
45        "ARVO_API_KEY": "arvo_your_api_key_here"
46      }
47    }
48  }
49}
50```
51 
52**Config file location:**
53- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
54- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
55 
56#### Cursor
57 
58Add to your Cursor MCP settings:
59 
60```json
61{
62  "mcpServers": {
63    "arvo": {
64      "command": "npx",
65      "args": ["-y", "arvo-mcp"],
66      "env": {
67        "ARVO_API_KEY": "arvo_your_api_key_here"
68      }
69    }
70  }
71}
72```
73 
74### 3. Start chatting!
75 
76After restarting your AI client, try asking:
77 
78- *"What's my workout for today?"*
79- *"Show me my recent PRs"*
80- *"How's my progress on bench press?"*
81- *"What muscle groups am I training this week?"*
82 
83## Available Tools
84 
85### Read-Only Tools (19)
86 
87| Tool | Description |
88|------|-------------|
89| `get_user_profile` | Get your fitness profile, experience level, and preferences |
90| `get_active_split` | Get your current training split and schedule |
91| `get_recent_workouts` | View your most recent completed workouts |
92| `get_workout_for_day` | Get the workout for any cycle day |
93| `get_workout_stats` | Get aggregated training statistics |
94| `get_active_insights` | View AI-generated training insights |
95| `get_personal_records` | See your PRs for each exercise |
96| `get_exercise_progress` | Track progression for specific exercises |
97| `get_exercise_video` | Get demonstration videos for exercises |
98| `get_volume_by_muscle` | View volume distribution by muscle group |
99| `get_coach_info` | Get your coach's information |
100| `get_coach_notes` | View notes from your coach |
101| `get_approach_details` | Learn about your training methodology |
102| `get_body_progress` | Track body composition changes |
103| `get_cycle_history` | View training cycle history |
104| `get_booking_info` | See your PT session bookings |
105| `get_ai_memory` | Access saved AI context about you |
106| `get_caloric_history` | View caloric phase history |
107| `get_approach_history` | See methodology changes over time |
108 
109### Write Tools (10)
110 
111| Tool | Description |
112|------|-------------|
113| `save_memory` | Save notes for the AI to remember |
114| `update_caloric_phase` | Change your current bulk/cut/maintain phase |
115| `update_weak_points` | Update priority muscle groups |
116| `report_physical_issue` | Log pain or injuries |
117| `skip_exercise` | Skip an exercise in today's workout |
118| `generate_workout` | Generate a new workout |
119| `update_equipment` | Update your available equipment |
120| `add_exercise` | Add an exercise to your workout |
121| `swap_exercise` | Request exercise alternatives |
122| `apply_swap` | Apply an exercise swap |
123 
124## Security
125 
126- Your API key is stored locally and never sent to third parties
127- All communication uses HTTPS
128- API keys can be revoked anytime from your Arvo dashboard
129- Each key has configurable scopes (read/write)
130 
131For security vulnerability reports, see [SECURITY.md](SECURITY.md).
132 
133## FAQ
134 
135### What is the Model Context Protocol (MCP)?
136 
137MCP is an open protocol that enables AI assistants like Claude to securely access external data sources. arvo-mcp lets Claude access your workout data, training history, and fitness metrics through natural conversation.
138 
139### How is my data protected?
140 
141- API keys are hashed with SHA-256 (never stored in plaintext)
142- All communication uses HTTPS encryption
143- Keys can be revoked instantly from your dashboard
144- Scoped permissions (read-only or read-write)
145- Your API key is stored only on your local machine
146 
147### Can I use this offline?
148 
149No, arvo-mcp requires an internet connection to communicate with arvo.guru servers. The MCP server runs locally but fetches your data from the cloud.
150 
151### What AI clients are supported?
152 
153Claude Desktop, Cursor, Windsurf, and any MCP-compatible client. The server uses the standard MCP stdio transport, making it compatible with any client that supports the protocol.
154 
155### How do I report security issues?
156 
157Email security@arvo.guru with details. See [SECURITY.md](SECURITY.md) for our full security policy and responsible disclosure process.
158 
159### What data can the AI access?
160 
161The AI can access your workout plans, exercise history, personal records, body composition tracking, and coach notes. Write tools allow saving memories, updating preferences, and modifying workouts. You control access through API key scopes.
162 
163### Does this work without an Arvo account?
164 
165No, you need an Arvo account to generate an API key. Sign up free at [arvo.guru](https://arvo.guru).
166 
167### How do I update to a new version?
168 
169If you use `npx -y arvo-mcp`, it automatically fetches the latest version. For global installations, run `npm update -g arvo-mcp`.
170 
171## Environment Variables
172 
173| Variable | Required | Description |
174|----------|----------|-------------|
175| `ARVO_API_KEY` | Yes | Your Arvo API key |
176| `ARVO_BASE_URL` | No | API base URL (default: `https://arvo.guru`) |
177 
178## Requirements
179 
180- Node.js 18+
181- An Arvo account ([sign up free](https://arvo.guru))
182 
183## Links
184 
185- **Arvo - AI Personal Trainer**: [arvo.guru](https://arvo.guru)
186- **Documentation**: [arvo.guru/docs](https://arvo.guru/docs)
187- **Report Issues**: [GitHub Issues](https://github.com/khaoss85/arvo-mcp/issues)
188- **MCP Protocol**: [modelcontextprotocol.io](https://modelcontextprotocol.io)
189- **npm Package**: [npmjs.com/package/arvo-mcp](https://www.npmjs.com/package/arvo-mcp)
190 
191## Related
192 
193Looking for fitness tracking with AI? Check out:
194- [Arvo](https://arvo.guru) - AI workout coach that creates personalized training programs
195- [Model Context Protocol](https://modelcontextprotocol.io) - The open protocol powering this integration
196 
197## License
198 
199MIT - see [LICENSE](LICENSE) for details.
200 
201---
202 
203<p align="center">
204  <strong>🏋️ Track your gym workouts with AI</strong><br>
205  <a href="https://arvo.guru">Get started with Arvo →</a>
206</p>
207