Hevy MCP

🚀 Hevy-MCP: Model Context Protocol (MCP) Server for Hevy Fitness App API

A Model Context Protocol (MCP) server implementation that interfaces with the Hevy fitness tracking app and its API. This server enables AI assistants to access and manage training data, plans, workout templates, etc. via the Hevy API (PRO subscription required).

✨ Features

• Training Management: Retrieve, create, and update trainings.
• Plan Management: Access and manage training plans.
• Workout Templates: Browse available workout templates.
• Folder Organization: Manage plan folders.

📋 Prerequisites

• Node.js (v20 or higher)
• npm or yarn
• Hevy API key

📦 Installation

Install via Smithery

To automatically install hevy-mcp for Claude Desktop using Smithery:

npx -y @smithery/cli install @chrisdoc/hevy-mcp --client claude

Manual Installation

# Clone the repository
git clone https://github.com/chrisdoc/hevy-mcp.git
cd hevy-mcp

# Install dependencies
npm install

# Create a .env file from the sample
cp .env.sample .env
# Edit .env and add your Hevy API key

Integration with Cursor

To use this MCP server with Cursor, update the ~/.cursor/mcp.json file and add the following configuration:

{
  "hevy-mcp-server": {
    "command": "npx",
    "args": ["-y", "hevy-mcp"],
    "env": {
      "HEVY_API_KEY": "your-api-key-here"
    }
  }
}

Replace your-api-key-here with your actual Hevy API key.

⚙️ Configuration

Create a .env file in the project root directory with the following content:

HEVY_API_KEY=your_hevy_api_key_here

Replace your_hevy_api_key_here with your actual Hevy API key.

💻 Usage Examples

After Installation

npm start # Start the server

Functional Modules

Training Management

• Retrieve all trainings.
• Create a new training.
• Update an existing training.
• Delete a training.

Plan Management

• Retrieve all plans.
• Create a new plan.
• Update an existing plan.
• Delete a plan.

Workout Templates

• Retrieve all workout templates.
• Create a new workout template.
• Update an existing workout template.
• Delete a workout template.

Folder Organization

• Create a folder.
• Retrieve the folder list.
• Update the folder structure.
• Delete a folder.

Project Structure

hevy-mcp/
├── src/
│   ├── index.js       # Entry file
│   ├── server.js     # Server configuration
│   └── routes/       # Routing modules
│       ├── workouts.js    # Training routes
│       ├── plans.js      # Plan routes
│       └── templates.js  # Workout template routes
├── public/
│   └── .env          # Environment variable file
└── package.json     # Dependency management

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

👏 Contribution

Contributions are welcome! Feel free to submit a Pull Request.

🙏 Acknowledgments

• Model Context Protocol for the MCP SDK.
• Hevy for their fitness tracking platform and API.