Official MCP server for Arvo - AI workout coach. Access your training data through Claude Desktop, Cursor, and other MCP clients.
npm install arvo-mcp> 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.
arvo-mcp is a Model Context Protocol (MCP) server that connects your AI assistant to Arvo, 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.
Perfect for fitness enthusiasts who want to:
- 🏋️ Ask "What's my workout today?" and get your personalized training plan
- 📊 Track gym progress with AI-powered insights
- 💪 Monitor PRs, volume, and muscle group distribution
- 📈 Analyze body composition trends over time
- 29 fitness tools - Profile, workouts, splits, PRs, body progress, and more
- Read & Write access - View your data and make changes through natural conversation
- Secure API key authentication - Your data stays private
- Works with any MCP client - Claude Desktop, Cursor, Windsurf, and more
1. Sign up or log in at arvo.guru
2. Go to Settings → API Keys
3. Click Create Key and copy your API key
#### Claude Desktop
Add to your claude_desktop_config.json:
``json`
{
"mcpServers": {
"arvo": {
"command": "npx",
"args": ["-y", "arvo-mcp"],
"env": {
"ARVO_API_KEY": "arvo_your_api_key_here"
}
}
}
}
Config file location:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
#### Cursor
Add to your Cursor MCP settings:
`json`
{
"mcpServers": {
"arvo": {
"command": "npx",
"args": ["-y", "arvo-mcp"],
"env": {
"ARVO_API_KEY": "arvo_your_api_key_here"
}
}
}
}
After restarting your AI client, try asking:
- "What's my workout for today?"
- "Show me my recent PRs"
- "How's my progress on bench press?"
- "What muscle groups am I training this week?"
| Tool | Description |
|------|-------------|
| get_user_profile | Get your fitness profile, experience level, and preferences |get_active_split
| | Get your current training split and schedule |get_recent_workouts
| | View your most recent completed workouts |get_workout_for_day
| | Get the workout for any cycle day |get_workout_stats
| | Get aggregated training statistics |get_active_insights
| | View AI-generated training insights |get_personal_records
| | See your PRs for each exercise |get_exercise_progress
| | Track progression for specific exercises |get_exercise_video
| | Get demonstration videos for exercises |get_volume_by_muscle
| | View volume distribution by muscle group |get_coach_info
| | Get your coach's information |get_coach_notes
| | View notes from your coach |get_approach_details
| | Learn about your training methodology |get_body_progress
| | Track body composition changes |get_cycle_history
| | View training cycle history |get_booking_info
| | See your PT session bookings |get_ai_memory
| | Access saved AI context about you |get_caloric_history
| | View caloric phase history |get_approach_history
| | See methodology changes over time |
| Tool | Description |
|------|-------------|
| save_memory | Save notes for the AI to remember |update_caloric_phase
| | Change your current bulk/cut/maintain phase |update_weak_points
| | Update priority muscle groups |report_physical_issue
| | Log pain or injuries |skip_exercise
| | Skip an exercise in today's workout |generate_workout
| | Generate a new workout |update_equipment
| | Update your available equipment |add_exercise
| | Add an exercise to your workout |swap_exercise
| | Request exercise alternatives |apply_swap
| | Apply an exercise swap |
- Your API key is stored locally and never sent to third parties
- All communication uses HTTPS
- API keys can be revoked anytime from your Arvo dashboard
- Each key has configurable scopes (read/write)
For security vulnerability reports, see SECURITY.md.
MCP 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.
- API keys are hashed with SHA-256 (never stored in plaintext)
- All communication uses HTTPS encryption
- Keys can be revoked instantly from your dashboard
- Scoped permissions (read-only or read-write)
- Your API key is stored only on your local machine
No, arvo-mcp requires an internet connection to communicate with arvo.guru servers. The MCP server runs locally but fetches your data from the cloud.
Claude 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.
Email security@arvo.guru with details. See SECURITY.md for our full security policy and responsible disclosure process.
The 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.
No, you need an Arvo account to generate an API key. Sign up free at arvo.guru.
If you use npx -y arvo-mcp, it automatically fetches the latest version. For global installations, run npm update -g arvo-mcp.
| Variable | Required | Description |
|----------|----------|-------------|
| ARVO_API_KEY | Yes | Your Arvo API key |ARVO_BASE_URL
| | No | API base URL (default: https://arvo.guru`) |
- Node.js 18+
- An Arvo account (sign up free)
- Arvo - AI Personal Trainer: arvo.guru
- Documentation: arvo.guru/docs
- Report Issues: GitHub Issues
- MCP Protocol: modelcontextprotocol.io
- npm Package: npmjs.com/package/arvo-mcp
Looking for fitness tracking with AI? Check out:
- Arvo - AI workout coach that creates personalized training programs
- Model Context Protocol - The open protocol powering this integration
MIT - see LICENSE for details.
---
🏋️ Track your gym workouts with AI
Get started with Arvo →