Zepp Life

FreeNot checked

MCP server that provides local caching, sync, and tools for Zepp Life health data including steps, sleep, heart rate, workouts, and body measurements, supportin

by kubulashvili

GitHub Embed

About

MCP server that provides local caching, sync, and tools for Zepp Life health data including steps, sleep, heart rate, workouts, and body measurements, supporting both file exports and cloud session access.

README

CI Release License

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 targets these data types:

steps and daily activity
sleep
heart rate
workouts
body 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.

Install

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

Setup

Cloud session

You need an apptoken.

Typical flow:

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

Then configure the server:

zepp-life-mcp setup --mode cloud_session --token "<apptoken>" --user-id "<userId>" --region eu
zepp-life-mcp doctor

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"]
    }
  }
}

Example prompts

Show my workouts from the last 30 days
How has my weight changed this year?
Summarize my sleep for the past week
Sync my latest Zepp Life data

Commands

zepp-life-mcp --help
zepp-life-mcp setup --help
zepp-life-mcp doctor
zepp-life-mcp sync --help
zepp-life-mcp serve

Development

pytest
python -m build

Troubleshooting

Connection: failed
- verify apptoken
- verify user_id
No export data found
- verify the extracted archive path
- verify that CSV or JSON export files are present
sync returns no data
- try another date range
- try export mode if cloud coverage is incomplete

Security

apptoken is stored via the system keyring
do not commit .env, exported health data, or local SQLite files
prefer interactive setup over pasting secrets into shell history

Disclaimer

This is an unofficial project and is not affiliated with Xiaomi or Zepp Health.

from github.com/kubulashvili/zepp-life-mcp

Installing Zepp Life

This server has no published package — it is built from source. Open the repository and follow its README.

▸ github.com/kubulashvili/zepp-life-mcp

FAQ

Is Zepp Life MCP free?

Yes, Zepp Life MCP is free — one-click install via Unyly at no cost.

Does Zepp Life need an API key?

No, Zepp Life runs without API keys or environment variables.

Is Zepp Life hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Zepp Life in Claude Desktop, Claude Code or Cursor?

Open Zepp Life on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

GitHub

PRs, issues, code search, CI status

by GitHub

Filesystem

Secure file operations with configurable access controls.

by Community

Memory

Knowledge graph-based persistent memory system.