AgentStack
Sign in Publish
MCP servers Skills Toolkits Why AgentStack Sell Docs
Sign in
MCP verified MIT Self-run

Zepp Life Mcp

mcp-kubulashvili-zepp-life-mcp · by kubulashvili

MCP server for Zepp Life data access

↗ Repository
— No reviews yet
0 installs
5 views
0.0% view→install

Install

$ agentstack add mcp-kubulashvili-zepp-life-mcp

✓ scanned · ✓ verified — works with Claude Code, Cursor, and more.

Security review

✓ Passed

No issues found. Passed automated security review. · v0.1.0 How review works →

  • ✓ Prompt-injection patterns
  • ✓ Secret / credential exfiltration
  • ✓ Dangerous shell & filesystem operations
  • ✓ Untrusted network calls
  • ✓ Known-malicious package signatures

What it can access

  • ✓ Network access No
  • ✓ Filesystem access No
  • ✓ Shell / process execution No
  • ● Environment & secrets Used
  • ✓ Dynamic code execution No

From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.

Are you the author of Zepp Life Mcp? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

About

Zepp Life MCP

[](https://github.com/kubulashvili/zepp-life-mcp/actions/workflows/ci.yml) [](https://github.com/kubulashvili/zepp-life-mcp/releases) [](https://github.com/kubulashvili/zepp-life-mcp/blob/main/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:

  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 "" --user-id "" --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.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

Install and usage instructions live in the source repository linked above.

Reviews

No reviews yet — be the first.

Write a review

Versions

  • v0.1.0 Imported from the upstream source.

More in Integrations