Developer Hub

Build with Arvo

Connect your AI assistant to your fitness data. Track workouts, analyze progress, and automate your fitness tracking through natural conversation.

What is arvo-mcp?

arvo-mcp is an open source Model Context Protocol server that connects AI assistants to your Arvo fitness data. It enables Claude, Cursor, and other AI clients to read your workouts, track PRs, and analyze progress through natural conversation.

Why Build with Arvo?

Open Source

arvo-mcp is fully open source. Inspect the code, contribute features, or fork it for your needs.

29 API Tools

Access workout history, PRs, exercises, training splits, progress analytics, and more.

Standard Protocol

Built on Anthropic's Model Context Protocol for compatibility with the AI ecosystem.

Production Ready

Used by developers and fitness enthusiasts to automate their training workflows.

What You Can Build

Conversational Tracking

Ask your AI 'what's my workout today?' or 'show me my PRs' and get instant answers from your real data.

Progress Analysis

Build custom dashboards, generate automated reports, or create visualizations of your training trends.

Workflow Automation

Automate workout logging, reminders, and progress tracking. Integrate with other tools in your productivity stack.

Custom Integrations

Build custom integrations for your unique needs. The API supports reading and writing all fitness data.

Real World Examples

Conversational Tracking

"What's my workout today?"

Claude fetches your scheduled training plan and presents it to you.

Progress Analysis

"Show me my squat progress last month"

Get detailed performance trend analysis with real data from your workouts.

Smart Logging

"I did 5 sets of bench press, 100kg x 8 reps"

Log workouts through natural language without navigating the app.

Quick Start

1

Install arvo-mcp

Use npm or yarn to install the MCP package

npm install arvo-mcp
2

Configure your AI client

Add arvo-mcp to Claude Desktop or Cursor

3

Start conversing

Ask your AI about your workouts

Security & Privacy

Your data stays yours. MCP connections are authenticated, AI doesn't store credentials, and you control exactly what data to share.

Frequently Asked Questions

What is the Model Context Protocol (MCP)?

MCP is an open protocol by Anthropic that allows AI assistants like Claude to interact with external tools and data sources. Arvo's MCP server lets AI assistants read and write workout data directly.

Which AI clients support Arvo MCP?

arvo-mcp works with Claude Desktop, Cursor IDE, Windsurf, and any AI client that supports the Model Context Protocol. Setup takes under 2 minutes.

Is my fitness data secure when using MCP?

Yes. MCP connections are authenticated via your personal API key. The AI only accesses your data through Arvo's secure API, never storing credentials. You control exactly what data the AI can access.

What can I do with the Arvo API?

Read workout history, track PRs, log exercises, manage training splits, analyze progress trends, and automate your fitness tracking. The API supports 29 different tools for comprehensive fitness data management.

Is there a rate limit or cost?

The MCP server is free for all Arvo users. API rate limits are generous for personal use. Enterprise or high-volume integrations can contact us for custom solutions.

Can I contribute to arvo-mcp?

Absolutely! arvo-mcp is open source on GitHub. We welcome contributions, bug reports, and feature requests from the community.

What programming languages does arvo-mcp support?

arvo-mcp is built with TypeScript and runs on Node.js. It follows the Model Context Protocol specification, so any MCP-compatible client can connect regardless of language.

How do I get my Arvo API key?

You can generate your API key from the Arvo app settings. Go to Settings > Developer > API Key. The key is personal and should be kept secure.

Can AI assistants create workouts for me?

Yes! With arvo-mcp, AI assistants can both read your existing data and write new workouts. You can ask Claude to create a training split, log exercises, or plan your next session based on your history.

What's the difference between MCP and REST API?

MCP is specifically designed for AI assistant integration with bidirectional, real-time communication. The REST API (coming soon) is for traditional programmatic access. Use MCP for AI workflows, REST for custom apps.

Ready to Build?

Start connecting your AI assistant to your fitness data today.

Get Started with MCP