# Hevy MCP Server

> A community MCP server, not by Hevy: your agent reads, analyzes and logs your Hevy workouts, routines and body measurements.

A community-built MCP server by Christoph Kieslich (chrisdoc) for the Hevy workout tracking app. It isn't made by Hevy. It lets your agent read, analyze, create and update your Hevy workouts, routines, exercise templates and body measurements through Hevy's API.

What you can do with it
- Summarize your recent training and body-measurement trends in one call
- Find workouts, routines and exercises, and look up your past sets for an exercise
- Log a completed workout, or create and update routines and routine folders
- Create custom exercise templates
- Record and update dated body measurements

How it connects
It runs on your machine with npx -y hevy-mcp and needs Node.js 20 or newer. It needs a Hevy API key in HEVY_API_KEY. Hevy only offers API keys with Hevy PRO; you create one in Hevy's settings. The server checks the key when it starts and stops if Hevy rejects it. The maker also runs a hosted endpoint at https://mcp.hevy-mcp.dev/mcp, where you send your key as a bearer token or paste it once on its sign-in page.

Good to know
- Create and update tools change your Hevy account. There are no delete tools, and a retried create can make a duplicate, so use your agent's tool confirmations if it has them.
- The install steps here use version 3.2.1, the version in the MCP Registry. The maker's newest release is on npm as hevy-mcp.
- The npm package sends usage telemetry about its tool calls, such as tool names and error types, to the maker's own collector and to Sentry. The maker says it leaves out your workout content and measurement values. Newer versions let you turn it off with HEVY_MCP_TELEMETRY=0.
- It works with your training log. What your agent says about that data isn't medical advice.

- Type: Plugin
- Made by: chrisdoc
- Category: Health & fitness
- Formats: Local MCP
- Version: 3.2.1
- Website: https://hevy-mcp.dev
- Source: https://github.com/chrisdoc/hevy-mcp
- Page: https://pluginboard.ai/plugins/hevy-mcp-server

## Works with

- Claude
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- OpenClaw
- OpenCode
- Hermes Agent

## Install

You'll need:

- `HEVY_API_KEY` (required): API key for authenticating with the Hevy API

Replace each `<NAME>` placeholder with your own value.

### Claude

Add to claude_desktop_config.json:

```json
{
  "mcpServers": {
    "hevy-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "hevy-mcp@3.2.1"
      ],
      "env": {
        "HEVY_API_KEY": "<HEVY_API_KEY>"
      }
    }
  }
}
```

### GitHub Copilot

Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22hevy-mcp-server%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22hevy-mcp%403.2.1%22%5D%2C%22env%22%3A%7B%22HEVY_API_KEY%22%3A%22%3CHEVY_API_KEY%3E%22%7D%7D

Run in your terminal:

```shell
code --add-mcp '{"name":"hevy-mcp-server","command":"npx","args":["-y","hevy-mcp@3.2.1"],"env":{"HEVY_API_KEY":"<HEVY_API_KEY>"}}'
```

Copilot CLI:

```shell
copilot mcp add hevy-mcp-server --env HEVY_API_KEY=<HEVY_API_KEY> -- npx -y hevy-mcp@3.2.1
```

### Cursor

Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=hevy-mcp-server&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImhldnktbWNwQDMuMi4xIl0sImVudiI6eyJIRVZZX0FQSV9LRVkiOiI8SEVWWV9BUElfS0VZPiJ9fQ%3D%3D

Add to .cursor/mcp.json:

```json
{
  "mcpServers": {
    "hevy-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "hevy-mcp@3.2.1"
      ],
      "env": {
        "HEVY_API_KEY": "<HEVY_API_KEY>"
      }
    }
  }
}
```

### Claude Code

Run in your terminal:

```shell
claude mcp add -e HEVY_API_KEY=<HEVY_API_KEY> hevy-mcp-server -- npx -y hevy-mcp@3.2.1
```

### Codex

Run in your terminal:

```shell
codex mcp add --env HEVY_API_KEY=<HEVY_API_KEY> hevy-mcp-server -- npx -y hevy-mcp@3.2.1
```

### Antigravity

Add to ~/.gemini/config/mcp_config.json:

```json
{
  "mcpServers": {
    "hevy-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "hevy-mcp@3.2.1"
      ],
      "env": {
        "HEVY_API_KEY": "<HEVY_API_KEY>"
      }
    }
  }
}
```

### Gemini CLI

Run in your terminal:

```shell
gemini mcp add -e HEVY_API_KEY=<HEVY_API_KEY> hevy-mcp-server npx -y hevy-mcp@3.2.1
```

### OpenClaw

In a terminal: Run openclaw mcp add hevy-mcp-server --command npx, with --arg before each argument (-y hevy-mcp@3.2.1) and --env NAME=value for each variable it needs.

### OpenCode

Run in your terminal:

```shell
opencode mcp add hevy-mcp-server --env HEVY_API_KEY=<HEVY_API_KEY> -- npx -y hevy-mcp@3.2.1
```

### Hermes Agent

Add to ~/.hermes/config.yaml:

```json
{
  "mcp_servers": {
    "hevy-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "hevy-mcp@3.2.1"
      ],
      "env": {
        "HEVY_API_KEY": "<HEVY_API_KEY>"
      }
    }
  }
}
```

---
From Pluginboard (https://pluginboard.ai).