MCP.so
登录

Hevy MCP Server

@SrdjanCodes

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

SrdjanCodes

提交者

Srdan Mijuskovic

关于 Hevy MCP Server

暂无概览

Hevy MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "hevy-mcp-srdjancodes": {
      "command": "python",
      "args": [
        "server.py"
      ]
    }
  }
}

Hevy MCP Server 工具

4

`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_webhooks`, `create_webhook`, `delete_webhook`

概览

What is Hevy Mcp?

Hevy Mcp is a Python Model Context Protocol (MCP) server that integrates with the Hevy fitness app API. It grants any MCP-compatible AI assistant (like Claude) full access to your Hevy workout data—enabling logging, retrieval, management of workouts, routines, exercises, body measurements, and webhooks.

How to use Hevy Mcp?

Install the server by cloning the repository and running pip install -r requirements.txt (requires Python 3.12+ and a Hevy Pro account). Configure it by adding the server to Claude Desktop’s claude_desktop_config.json, setting the command to python, pointing to the absolute path of server.py, and supplying your Hevy API key via the HEVY_API_KEY environment variable. Alternatively, set the environment variable and run python server.py directly.

Key features of Hevy Mcp

  • 25 tools covering every Hevy API endpoint
  • Full CRUD for workouts, routines, exercise templates, folders, body measurements, and webhooks
  • Pure Python—no build step required
  • Seamless integration with Claude Desktop or any MCP-compatible host

Use cases of Hevy Mcp

  • Ask your AI to show your last five workouts
  • Log a new workout with sets, reps, and weights via natural language
  • Create a Push/Pull/Legs routine
  • Track your body weight trend over the last month
  • Look up exercise template IDs or review bench press history

常见问题

1

What prerequisites do I need to use Hevy Mcp?

Python 3.12+ and a Hevy Pro account (required for API access). You also need an API key from the Hevy developer settings page.

2

How do I get an API key for Hevy Mcp?

Go to [hevy.com/settings?developer](https://hevy.com/settings?developer) and generate an API key. Provide it as the `HEVY_API_KEY` environment variable either in your Claude config or directly in your shell.

3

What transport and authentication does Hevy Mcp use?

It uses standard MCP local transport (via Claude Desktop’s `mcpServers` configuration) and authenticates with an API key passed as an environment variable. The key is sent with every request to the Hevy API.

4

Does Hevy Mcp store any of my data locally?

No. The server only communicates with the Hevy API; it does not persist workout data on your machine.

5

What tools are available in Hevy Mcp?

Twenty-five tools across eight categories: User (get user info), Workouts (list, get, count, events, create, update), Routines (list, get, create, update), Routine Folders (list, get, create), Exercise Templates (list, get, create), Exercise History (get history), Body Measurements (list, get, create, update), and Webhooks (list, create, delete).

评论

其他 分类下的更多 MCP 服务器