Open Source

Your AI Assistant, Your Fitness Data

arvo-mcp connects Claude Desktop, Cursor, and other AI clients directly to your workout data. Track PRs, analyze progress, and manage training through natural conversation.

View on GitHub
npm install arvo-mcp

What is arvo-mcp?

arvo-mcp is an open source Model Context Protocol server that lets AI assistants like Claude read and write your Arvo workout data. Install it, configure your API key, and start chatting with AI about your workouts.

What is the Model Context Protocol?

MCP is an open protocol by Anthropic that standardizes how AI assistants connect to external data. Instead of copy-pasting data into chats, MCP lets AI access your information directly - securely and under your control.

Features

29 Tools Available

Complete read and write access to workouts, PRs, exercises, training splits, body measurements, and more.

Natural Understanding

Ask 'what's my squat PR?' or 'log today's session' - the AI understands fitness context.

Open Source

Fully open code on GitHub. Inspect, modify, contribute. No black boxes.

Secure by Design

API key authentication, no credentials stored, revoke access anytime.

Supported AI Clients

arvo-mcp works with any client that supports the Model Context Protocol:

Claude Desktop
Cursor IDE
Windsurf
Cline
+ any MCP client

Quick Start

1

Install the package

npm install -g arvo-mcp
2

Configure Claude Desktop

Add to your Claude configuration file:

{
  "mcpServers": {
    "arvo": {
      "command": "npx",
      "args": ["-y", "arvo-mcp"],
      "env": {
        "ARVO_API_KEY": "your-api-key"
      }
    }
  }
}
3

Start chatting

Open Claude and ask about your workouts:

"What's my workout today?"
"Show me my PRs"
"Log 3x8 squats at 100kg"
"How's my progress this month?"

Available Tools

arvo-mcp provides 29 tools for comprehensive fitness data management:

Read

get_workoutsRetrieve workout history
get_workout_by_idGet specific workout details
get_personal_recordsView all-time PRs
get_exercisesList available exercises
get_exercise_historyTrack exercise progress
get_training_splitView current split
get_profileGet user profile data
get_body_measurementsTrack body measurements

Write

log_workoutLog a new workout
log_exerciseLog exercise sets
update_personal_recordUpdate a PR
create_workout_planGenerate workout plan

+ 17 more tools for complete fitness data management

Use Cases

Conversational Tracking

Chat with Claude about your workouts. Ask about PRs, history, progress - all in natural language without opening the app.

Quick Logging

Log workouts while you work. Just tell Claude and update your data without breaking your flow.

Progress Analysis

Ask Claude to analyze your trends, identify plateaus, suggest adjustments based on your real data.

Workout Planning

Let Claude generate workouts based on your history, preferences, and goals. The AI knows your data.

Security & Privacy

  • Authentication via personal API key
  • No credentials stored by AI
  • All data flows through secure Arvo APIs
  • Revoke access anytime from settings
  • Open source code - verify yourself

Frequently Asked Questions

What is the Model Context Protocol (MCP)?

MCP is an open protocol developed by Anthropic that creates a standardized way for AI assistants to interact with external tools and data sources. Instead of training AI on static data, MCP lets AI access real-time information from your apps. arvo-mcp implements this protocol for fitness data.

How do I connect Claude to my workout data?

Install arvo-mcp via npm, add your Arvo API key to the configuration file, and add arvo-mcp to your Claude Desktop or Cursor settings. The AI will automatically have access to your workout history, PRs, and training data.

What AI clients are supported?

arvo-mcp works with any MCP-compatible client including Claude Desktop (macOS, Windows), Cursor IDE, Windsurf, and other tools implementing the Model Context Protocol. More clients are adding MCP support regularly.

Is my fitness data secure?

Yes. All connections are authenticated via your personal API key. The AI accesses data through Arvo's secure API - it never stores your credentials. You maintain full control over what data the AI can access, and you can revoke access anytime.

What can I ask the AI about my workouts?

You can ask natural language questions like 'What's my bench press PR?', 'Show my workout history this week', 'What exercises target my chest?', 'Log 3 sets of 8 reps at 100kg for squats', or 'Create a push day workout'. The AI understands fitness context.

Can the AI modify my workout data?

Yes, with your permission. arvo-mcp supports both read and write operations. The AI can log workouts, update PRs, modify your training split, and track exercises - all through natural conversation. Write operations require explicit confirmation.

Is arvo-mcp free?

Yes, arvo-mcp is completely free and open source. You need an Arvo account (free or paid) to access your workout data. There are no additional charges for using the MCP server.

How is this different from ChatGPT plugins?

MCP is a local-first protocol - the AI runs on your computer and connects directly to data sources. This means better privacy (no data sent to third parties), offline capability, and faster responses. It's also standardized across multiple AI clients.

Ready to Connect Your AI?

Start tracking your workouts with Claude in under 2 minutes.