Skip to main content
Glama
Sign In
deenesjakoruzh
hevy-mcp

hevy-mcp

by SrdjanCodes
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

hevy-mcp

一个用于 Hevy 健身应用 API 的 Python 模型上下文协议 (MCP) 服务器。让 Claude（或任何兼容 MCP 的 AI）能够完全访问您的 Hevy 锻炼数据——记录锻炼、管理例程、追踪身体测量数据等。

功能

  • 25 个工具，涵盖 Hevy API 的每一个端点

  • 无需构建步骤——纯 Python，安装即可运行

  • 完整的 CRUD——创建、读取、更新锻炼、例程、练习模板、文件夹、测量数据和 Webhook

Related MCP server: Hevy MCP Pro

工具

分类

工具

用户

get_user_info

锻炼

get_workouts, get_workout, get_workout_count, get_workout_events, create_workout, update_workout

例程

get_routines, get_routine, create_routine, update_routine

例程文件夹

get_routine_folders, get_routine_folder, create_routine_folder

练习模板

get_exercise_templates, get_exercise_template, create_exercise_template

练习历史

get_exercise_history

身体测量

get_body_measurements, get_body_measurement, create_body_measurement, update_body_measurement

Webhooks

get_webhooks, create_webhook, delete_webhook

要求

安装

git clone https://github.com/YOUR_USERNAME/hevy-mcp
cd hevy-mcp
pip install -r requirements.txt

配置

Claude Desktop

添加到 claude_desktop_config.json：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "hevy": {
      "command": "python",
      "args": ["/absolute/path/to/hevy-mcp/server.py"],
      "env": {
        "HEVY_API_KEY": "your-api-key-here"
      }
    }
  }
}

重启 Claude Desktop。您应该能在聊天界面的工具图标下看到 Hevy 服务器。

环境变量

或者，在您的环境中设置 HEVY_API_KEY 并直接运行：

export HEVY_API_KEY=your-api-key-here
python server.py

使用示例

连接后，您可以询问 Claude 诸如：

  • “显示我最近 5 次的锻炼记录”

  • “记录我今天做的胸部锻炼——卧推 3 组 8 次，重量 100kg；上斜哑铃推举 3 组 10 次，重量 30kg”

  • “创建一个推/拉/腿例程”

  • “我过去一个月的体重趋势如何？”

  • “查找罗马尼亚硬拉的练习模板 ID”

  • “显示我过去 3 个月所有的卧推组数”

技术栈

许可证

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Hevy MCP

    chrisdoc
    A
    license
    A
    quality
    A
    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).
    23
    2,128 npm
    530
    MIT

  • Hevy MCP Pro

    cbotworks
    A
    license
    B
    quality
    D
    maintenance
    A production-ready MCP server for the Hevy fitness API that exposes 27 tools for reading, writing, and analyzing workout data, enabling LLM-driven personal trainer workflows.
    27
    6 npm
    MIT

  • hevy-mcp

    andreparmar
    A
    license
    A
    quality
    C
    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.
    26
    2,128 npm
    MIT

  • Hevy Fitness MCP Server

    phaiel
    A
    license
    Not graded
    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.
    10 npm
    MIT

Appeared in Searches