# Zepp Life Mcp

> MCP server for Zepp Life data access

- **Type:** MCP server
- **Install:** `agentstack add mcp-kubulashvili-zepp-life-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [kubulashvili](https://agentstack.voostack.com/s/kubulashvili)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [kubulashvili](https://github.com/kubulashvili)
- **Source:** https://github.com/kubulashvili/zepp-life-mcp

## Install

```sh
agentstack add mcp-kubulashvili-zepp-life-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## 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

```bash
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:

```bash
zepp-life-mcp setup --mode cloud_session --token "" --user-id "" --region eu
zepp-life-mcp doctor
```

### Export file mode

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

## Use

```bash
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:

```json
{
  "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

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

## Development

```bash
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.

- **Author:** [kubulashvili](https://github.com/kubulashvili)
- **Source:** [kubulashvili/zepp-life-mcp](https://github.com/kubulashvili/zepp-life-mcp)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-kubulashvili-zepp-life-mcp
- Seller: https://agentstack.voostack.com/s/kubulashvili
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.