-
securityA
license-
qualityMCP Server simplifies the implementation of the Model Context Protocol by providing a user-friendly API to create custom tools and manage server workflows efficiently.
Last updated -
4
3
TypeScript
MIT License
The Hevy MCP server enables AI assistants to interact with the Hevy fitness tracking app API for comprehensive fitness data management:
- Workout Management: Fetch, create, update, and track workouts with detailed exercise data
- Routine Management: Access, create, update, and organize workout routines
- Exercise Templates: Browse and retrieve both standard and custom exercise templates
- Folder Organization: Create and manage folders to categorize routines effectively
Utilized for code formatting and linting in the development process of the MCP server.
Used for environment variable configuration to store the Hevy API key.
Used for version control of the MCP server codebase.
Hosts the repository for the MCP server codebase.
Provides tools for accessing and managing workout data, routines, exercise templates, and folders through the Hevy fitness app API, enabling workout tracking and fitness management capabilities.
Required as a runtime environment (v20 or higher) for running the MCP server.
Used as a package manager for installing and managing dependencies of the MCP server.
Provides badge for license information in the README.
Supported as an alternative package manager for installing and managing dependencies.
hevy-mcp: Model Context Protocol Server for Hevy Fitness 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 workout data, routines, exercise templates, and more through the Hevy API (requires PRO subscription).
Features
- Workout Management: Fetch, create, and update workouts
- Routine Management: Access and manage workout routines
- Exercise Templates: Browse available exercise templates
- Folder Organization: Manage routine folders
Prerequisites
- Node.js (v20 or higher)
- npm or yarn
- A Hevy API key
Installation
Installing via Smithery
To install hevy-mcp for Claude Desktop automatically via Smithery:
Manual Installation
Integration with Cursor
To use this MCP server with Cursor, you need to update your ~/.cursor/mcp.json file by adding the following configuration:
Make sure to replace your-api-key-here with your actual Hevy API key.
Configuration
Create a .env file in the project root with the following content:
Replace your_hevy_api_key_here with your actual Hevy API key.
Usage
Development
This starts the MCP server in development mode with hot reloading.
Production
Available MCP Tools
The server implements the following MCP tools:
Workout Tools
get-workouts: Fetch and format workout dataget-workout: Get a single workout by IDcreate-workout: Create a new workoutupdate-workout: Update an existing workoutget-workout-count: Get the total count of workoutsget-workout-events: Get workout update/delete events
Routine Tools
get-routines: Fetch and format routine datacreate-routine: Create a new routineupdate-routine: Update an existing routineget-routine: Get a single routine by ID
Exercise Template Tools
get-exercise-templates: Fetch exercise templatesget-exercise-template: Get a template by ID
Routine Folder Tools
get-routine-folders: Fetch routine folderscreate-routine-folder: Create a new folderget-routine-folder: Get a folder by ID
Project Structure
Development
Code Style
This project uses Biome for code formatting and linting:
Generating API Client
The API client is generated from the OpenAPI specification using Kiota:
License
This project is licensed under the MIT License - see the LICENSE file for details.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Acknowledgements
- Model Context Protocol for the MCP SDK
- Hevy for their fitness tracking platform and API
You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
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 workout data, routines, exercise templates, and more through the Hevy API (requires PRO subscription).
Related MCP Servers
- -securityAlicense-qualityMCP Server provides a simpler API to interact with the Model Context Protocol by allowing users to define custom tools and services to streamline workflows and processes.Last updated -132TypeScriptMIT License
- -security-license-qualityA Model Context Protocol (MCP) server that interacts with system APIs, allowing users to check connections, search employees, register breakfast, and update chemical information by shifts.Last updated -2
- AsecurityAlicenseAqualityA Model Context Protocol (MCP) server that provides access to Crunchbase data for AI assistants. This server allows AI assistants to search for companies, get company details, funding information, acquisitions, and people data from Crunchbase.Last updated -53JavaScriptMIT License