Installation

Run via npx (recommended)

You can launch the server directly without cloning:

HEVY_API_KEY=your_hevy_api_key_here npx -y hevy-mcp

Manual Installation

# Clone the repository
git clone https://github.com/chrisdoc/hevy-mcp.git
cd hevy-mcp

# Install dependencies
corepack use pnpm@10.22.0
pnpm install

# Create .env and add your keys (never commit real keys)
cp .env.sample .env
# Edit .env and add your HEVY_API_KEY.

Integration with Cursor

To use this MCP server with Cursor, add/merge this server entry under "mcpServers" in ~/.cursor/mcp.json:

{
  "hevy-mcp": {
    "command": "npx",
    "args": ["-y", "hevy-mcp"],
    "env": {
      "HEVY_API_KEY": "your-api-key-here"
    }
  }
}

Make sure to replace your-api-key-here with your actual Hevy API key.

If your mcp.json already contains other servers, do not replace the whole file—merge the "hevy-mcp" entry into your existing "mcpServers" object.

The "hevy-mcp" key name is arbitrary. If you already have an existing config using a different name (for example "hevy-mcp-server"), you can keep it.

If you already have an existing "mcpServers" object, merge the "hevy-mcp" entry into it without removing other servers.

{
  "mcpServers": {
    "hevy-mcp": {
      "command": "npx",
      "args": ["-y", "hevy-mcp"],
      "env": {
        "HEVY_API_...