personal-health-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@personal-health-mcp get my latest body composition data"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
personal-health-mcp
タニタ ヘルスプラネット API から体組成データ(体重・体脂肪率)を取得し、MCP ツールとして Claude Desktop 等の AI エージェントに提供します。
セットアップ
1. インストール
pip install -e .2. .env を作成
cp .env.example .env.env を編集して HEALTH_PLANET_CLIENT_ID・HEALTH_PLANET_CLIENT_SECRET・HEALTH_PLANET_REDIRECT_URI を設定してください。
3. 初回認証
python -m health_mcp.tanita.auth表示された URL をブラウザで開き、「アクセスを許可する」をクリック後、リダイレクト URL を貼り付けると .env にトークンが保存されます。
4. Claude Desktop に MCP サーバーを登録
claude_desktop_config.json に以下を追加してください。command には venv 内の Python 実行ファイルのフルパスを指定します。
Windows:
{
"mcpServers": {
"personal-health": {
"command": "C:/Users/<username>/path/to/personal-health-mcp/venv/Scripts/python.exe",
"args": ["-m", "health_mcp.server"]
}
}
}macOS / Linux:
{
"mcpServers": {
"personal-health": {
"command": "/path/to/personal-health-mcp/venv/bin/python",
"args": ["-m", "health_mcp.server"]
}
}
}
cwdの指定は不要です。サーバーは__file__を基点にプロジェクトルートを自動解決します。
Related MCP server: vitals
MCP ツール一覧
ツール | 説明 |
| 最新の体重・体脂肪率を取得(直近30日対象) |
| 指定期間(最大92日)の体組成データを取得 |
| キャッシュ内データの日付範囲と件数を確認 |
| 生年月日・身長・性別を取得 |
| 取得可能なメトリクス一覧を表示 |
プロフィールの再取得
タニタアプリでプロフィール情報を変更した場合:
python -m health_mcp.tanita.auth --reset-profile開発
pip install -e ".[dev]"
pytest # テスト
mypy src # 型チェック
ruff check src # リントAvailable Tools
5 toolsget_body_compositionA
Return body composition data for a date range (max 92 days).
Inputs: end_date, start_date. Returns: object
get_latest_body_compositionA
Return the most recent body composition record within the last 30 days.
Inputs: no named parameters. Returns: object
get_measurements_rangeA
Return the date range and total count of cached body composition data.
Inputs: no named parameters. Returns: object
get_profileA
Return user profile (birth_date, height_cm, sex) from cache or API.
Inputs: no named parameters. Returns: object
list_available_metricsB
Return the list of available metrics and their descriptions.
Inputs: no named parameters. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Most tools are clearly distinct: get_latest_body_composition, get_body_composition, get_measurements_range, get_profile, and list_available_metrics each target different data or metadata. The minor overlap between 'latest' and 'range' variants is manageable due to clear descriptions.
Tool names predominantly follow a get_<resource> pattern, which is consistent and readable. The exception is list_available_metrics, which uses 'list_' instead of 'get_', a minor deviation that does not impede understanding.
Five tools is well within the ideal 3-15 range and appropriately scoped for a personal-health MCP focused on body composition and profile retrieval. No unnecessary tools are present.
The tool set covers read access to body composition data, profile information, and available metrics, but lacks write operations or management of cached data. Since the domain appears to be read-only retrieval from an external source, the core needs are met, though a few potential gaps exist (e.g., no single-metric query).
Maintenance
Related MCP Connectors
Log meals, water, and weight to Garmin Connect from Claude or ChatGPT.
MCP server for Withings health data — sleep, activity, heart, and body metrics.
Garmin data in Claude & ChatGPT via the Garmin Health API. OAuth sign-in, no password sharing.
Multi-tenant hosted MCP server for Oura Ring — 21 read-only tools, OAuth per user.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that connects Claude to Withings health data using OAuth 2.0. Provides 11 read-only tools to access body measurements, activity, sleep, heart rate, and device information from Withings devices.MIT
- AlicenseNot gradedqualityCmaintenanceExposes personal health data (recovery, sleep, strain, etc.) as MCP tools for AI agents to query and analyze.5MIT
- FlicenseNot gradedqualityDmaintenanceExposes Garmin Connect health data (steps, sleep, HR, HRV, stress, activities, etc.) as tools for MCP-compatible clients like Claude.-
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to query and analyze Renpho smart scale data (weight, body fat, etc.) by syncing it from the Renpho app and exposing it through MCP tools for conversational exploration.1MIT