広告掲載
MCP.so
ログイン

Hevy MCP Server

@VReippainen

リポジトリ

基本情報

カテゴリ

その他

ライセンス

MIT

トランスポート

stdio

作者

VReippainen

Hevy MCP Server について

概要はまだありません

Hevy MCP Server の設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "hevy-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@vreippainen/hevy-mcp-server",
        "--stdio"
      ],
      "env": {
        "HEVY_API_KEY": ""
      }
    }
  }
}

Hevy MCP Server のツール

4

Get workouts between start and end dates. Returns all workouts if no dates are provided. Returns workouts in descending order of date and limits the number of workouts returned. Max 10 workouts. Example: { "limit": 5, // Optional: Number of workouts (1-10, default: 10) "startDate": "2024-01-01T00:00:00Z", // Optional: Filter workouts after this date "endDate": "2024-03-20T23:59:59Z" // Optional: Filter workouts before this date }

Get progress history for specific exercises between start and end dates. Returns exercise data including weights, reps, and sets for each workout. Results are ordered by date descending. Useful for tracking progress over time for particular exercises. Example: { "exerciseIds": ["bench-press-123", "squat-456"], // Required: Array of exercise IDs "limit": 5, // Optional: Number of workouts (0-10, default: 10) "startDate": "2024-01-01T00:00:00Z", // Optional: Filter after this date "endDate": "2024-03-20T23:59:59Z" // Optional: Filter before this date }

Get comprehensive exercise data including frequency of use, categorization, and metadata. Results are sorted by usage frequency. Supports filtering by name search and date range. Example: { "searchTerm": "bench press", // Optional: Filter exercises by name "excludeUnused": true, // Optional: Skip never-performed exercises (default: true) "startDate": "2024-01-01T00:00:00Z", // Optional: Consider usage after this date "endDate": "2024-03-20T23:59:59Z" // Optional: Consider usage before this date }

Get user's saved workout routines. Returns all custom and preset routines with their full exercise details, including sets, reps, and rest periods. Example: {} // No parameters required

概要

What is Hevy MCP Server?

Hevy MCP Server is a TypeScript Node.js server that connects your Hevy workout data to language models via the Model Context Protocol (MCP). It fetches data from the Hevy API and provides tools for accessing workout history, exercise progress, and personal records, enabling AI assistants to analyze your workout data.

How to use Hevy MCP Server?

Install and invoke by adding a configuration to your ~/.cursor/mcp.json file using npx and setting the HEVY_API_KEY environment variable. Then use the provided tools (e.g., get-workouts, get-exercises) through an MCP‑compatible client.

Key features of Hevy MCP Server

  • get-workouts: Retrieve up to 10 workouts within a date range with duration and volume stats.
  • get-exercise-progress-by-ids: Track progress for specific exercises over time, filtered by date range.
  • get-exercises: Get comprehensive exercise data sorted by frequency, with optional name and date filtering.
  • get-routines: Retrieve your saved workout routines.
  • Workout prompt builder: Analyzes frequent exercises and routines to help AI create personalized recommendations.

Use cases of Hevy MCP Server

  • An AI assistant queries your recent workout history to suggest recovery adjustments.
  • Automatically track progress on specific exercises over a chosen time period.
  • Generate personalized workout plans based on your most-used exercises and saved routines.
  • Retrieve and review your saved workout routines for planning or analysis.

よくある質問

1

How do I obtain an API key for Hevy?

Visit the [Hevy API Documentation](https://api.hevyapp.com/docs/#/) and follow the authentication instructions. You need to sign up for API access through the Hevy developer portal.

2

What tools are available?

The server provides four tools: `get-workouts`, `get-exercise-progress-by-ids`, `get-exercises`, and `get-routines`.

3

Is there a limit on how many workouts I can fetch?

Yes, `get-workouts` returns a maximum of 10 workouts per call.

4

What environment variable is required?

The `HEVY_API_KEY` environment variable must be set to your Hevy API key.

5

How do I add this server to Cursor?

Update `~/.cursor/mcp.json` with the command `npx -y @vreippainen/hevy-mcp-server --stdio` and the `HEVY_API_KEY` environment variable.

コメント

「その他」の他のコンテンツ

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

Arsen MCP

Arsen Security

Run advanced phishing, voice phishing, deepfake fraud simulations, and cybersecurity awareness training from your AI assistant.

der die das – German noun genders (Lingviko)

Lingviko

The article (der, die, das) of 90,000 German nouns, compounds included, plus a checker that finds wrong articles in German text (“mit der Zug” → dem). Uses dictionary data, not AI guessing. Free, no login.

Glasswarp

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K
広告掲載