ゼップライフデータ用MCPサーバー

このプロジェクトでは、Zepp Life データのローカルキャッシュ、同期、および MCP ツールをエクスポートしたファイルや Zepp クラウドセッションフローから提供しています。

サポートされているソース

• ローカルZeppの輸出のための[export_file]
• [apptoken ベースのクラウドアクセス

現在のデータカバレッジ

現在の実装は以下をサポートしています。

• 毎日のステップ、間隔および活動的なカロリー
• 光、深い、REM、覚醒時間、およびウェイクカウントによる睡眠セッション
• 受動心拍数([[T3])を休む
• 既知のZeppスポーツコードの読みやすいスポーツ名を持つトレーニング
• 重量およびボディ構成の測定

クラウドカバレッジは、アカウント、地域、および上流エンドポイントの安定性によって異なる場合があります。 エクスポートモードは、予測可能なフル履歴アクセスが必要なときに最も安全なオプションです。

クラウド接続はレイジー:サーバー起動と[tools/list]]がZeppログインを待ちません。 最初のデータツールは1つの共有接続を確立します。 [user_idが省略されている場合、アダプターは、バンドサマリーデータの最後の30日間から数値UIDを発見し、システムキーリングに保存しようとします。

インストール

セットアップ

###クラウドセッション

apptoken が必要です。

典型的な流れ:

1. [https://user.huami.com/privacy2/index.を開く

Zepp Life MCP

MCP server for Zepp Life data.

This project provides local caching, sync, and MCP tools for Zepp Life data from either exported files or the Zepp cloud session flow.

Supported sources

• export_file for local Zepp exports
• cloud_session for apptoken-based cloud access

Current data coverage

The current implementation supports:

• daily steps, distance, and active calories
• sleep sessions with light, deep, REM, awake time, and wake count
• passive and resting heart rate (slp.rhr)
• workouts with readable sport names for known Zepp sport codes
• weight and body-composition measurements

Cloud coverage can vary by account, region, and upstream endpoint stability. Export mode is the safest option when you need predictable full-history access.

Cloud connections are lazy: server startup and tools/list do not wait for Zepp login. The first data tool establishes one shared connection. If user_id is omitted, the adapter attempts to discover the numeric UID from the last 30 days of band summary data and stores it in the system keyring.

Install

python -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'

Setup

Cloud session

You need an apptoken.

Typical flow:

1. Open https://user.huami.com/privacy2/index.html
2. Sign in to the Zepp Life account
3. Open browser DevTools
4. Find the apptoken cookie

Then configure the server:

zepp-life-mcp setup --mode cloud_session --token "" --region eu
zepp-life-mcp doctor

--user-id remains supported and can be supplied explicitly if automatic discovery is unavailable.

Export file mode

zepp-life-mcp setup --mode export_file --export-path ~/Downloads/ZeppExport
zepp-life-mcp doctor

Use

zepp-life-mcp sync --start-date 2022-01-01 --end-date 2022-12-31
zepp-life-mcp serve

MCP client config

Example Claude Desktop config:

{
  "mcpServers": {
    "zepp-life": {
      "command": "zepp-life-mcp",
      "args": ["serve"]
    }
  }
}

MCP tools

All tool responses keep the backward-compatible JSON envelope with status: "ok" or status: "error". Failed calls also use MCP isError: true.