Skip to main content
Glama
zachsai

Hevy MCP

by zachsai
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

Hevy MCP

An MCP (Model Context Protocol) server for Hevy — the workout tracking app. Connects any MCP-compatible AI client (Claude, Cursor, etc.) to your Hevy account, letting it read your workouts, routines, and exercises, or log new ones on your behalf.

Built with FastMCP and async httpx.

Requirements

  • Python 3.11+

  • uv package manager

  • Hevy Pro subscription (for API access)

  • Hevy API key (Settings > API in the Hevy app)

Related MCP server: hevy-mcp

Setup

# Clone and install
git clone https://github.com/zachsai/hevy-mcp.git
cd hevy-mcp
uv sync

# Configure
cp env.example .env
# Edit .env and add your HEVY_API_KEY

# Run locally
./run.sh

The server starts on http://localhost:8000 with streamable-HTTP transport.

Tools

Read

Tool

Description

get_workout_count

Total number of logged workouts

list_workouts

List workouts with pagination

get_workout

Full workout details (exercises, sets, weights)

list_routines

List saved routines

get_routine

Full routine details

search_exercises

Search exercise templates by name

Write

Tool

Description

create_workout

Log a new workout

update_workout

Update an existing workout

create_routine

Create a new routine

update_routine

Update an existing routine

Architecture

hevy_mcp/
├── server.py           # FastMCP server, Pydantic models, tool definitions
└── utils/
    ├── auth.py         # API key from environment
    └── hevy.py         # Async HTTP client for Hevy API v1

  • Auth: Static API key via api-key header (no OAuth complexity)

  • HTTP client: async httpx with pagination support

  • Models: Pydantic BaseModel for all tool inputs/outputs

Deployment

Docker (any platform)

Includes a Dockerfile for container deployment. The server reads PORT from the environment and exposes a /health_check endpoint.

docker build -t hevy-mcp .
docker run -e HEVY_API_KEY=your_key -e PORT=8080 hevy-mcp

Railway

This project is set up for one-click deployment on Railway. See RAILWAY_DEPLOY.md for the full step-by-step playbook covering:

  1. Creating the Railway project

  2. Deploying the Docker container

  3. Setting environment variables (HEVY_API_KEY, ENVIRONMENT)

  4. Generating a public domain

  5. Verifying the deployment (health check + MCP handshake)

The playbook documents the exact Railway MCP tool calls and parameters, so it can be followed manually or used as a reference for building an automated deployment skill with the Railway MCP server.

Development

uv run ruff check --fix   # Lint
uv run ruff format         # Format
uv run python tests/test_http.py   # Integration test (HTTP)
uv run python tests/test_stdio.py  # Integration test (stdio)

This server cannot be installed

F
license - not found
-
quality - not tested
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • Hevy MCP

    chrisdoc
    A
    license
    A
    quality
    B
    maintenance
    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).
    Last updated
    23
    4,871
    371
    MIT

  • hevy-mcp

    andreparmar
    A
    license
    A
    quality
    B
    maintenance
    An MCP server that interfaces with the Hevy fitness tracking API, enabling AI assistants to manage workouts, routines, exercise templates, and more via natural language.
    Last updated
    26
    4,871
    MIT

  • Hevy Fitness MCP Server

    phaiel
    A
    license
    -
    quality
    C
    maintenance
    A Model Context Protocol (MCP) server that provides AI assistants with access to the Hevy fitness tracking API. This allows you to log workouts, manage routines, browse exercises, and track your fitness progress directly through AI chat interfaces.
    Last updated
    4
    MIT

  • super-hevy-mcp

    stonelasley
    A
    license
    -
    quality
    C
    maintenance
    MCP server for the Hevy workout tracker that enables users to query training history, log workouts, and manage routines via natural language.
    Last updated
    MIT

View all related MCP servers

Related MCP Connectors

  • Hevy (unofficial)

    Create Hevy routines and analyze your training from chat. Unofficial; BYO Hevy PRO API key.

  • Withings Health Data

    MCP server for Withings health data — sleep, activity, heart, and body metrics.

  • anythingmcp

    Self-hosted MCP gateway: turn any API, database or MCP server into AI connectors — no code.

View all MCP Connectors

Appeared in Searches

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/zachsai/hevy-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server