miband-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
miband-mcp
Chenxi · Let AI read your wrist
A Python MCP Server with zero third-party dependencies: reads the SQLite database exported by Gadgetbridge (Xiaomi Band health data), and exposes it via the MCP protocol to any MCP-capable AI client (Reasonix / Claude / Cursor / Kimi / GLM, etc.), allowing AI to answer questions like "How many steps did I take today?" and "How did I sleep last night?".
Architecture
小米手环 9 / 9 Pro / 10 → Gadgetbridge(手机端采集)→ SQLite 导出 → miband-mcp(读库+聚合)→ MCP 协议 → AIRelated MCP server: Apple Health AI Bridge MCP Server
Provided Tools
Tool | Parameters | Returns |
|
| Last N heart rate readings (time + bpm) |
|
| Sleep/wake time, sleep stages (light/deep/rem), total duration |
|
| Steps, average/max/min heart rate |
Quick Start
1. Prepare the Data Source
Install Gadgetbridge on your phone (the official repository is on Codeberg, not GitHub)
Follow the official pairing guide to connect the band (Xiaomi Band 9 requires the band to initiate the connection: Band settings → System operations → Connect to a new phone)
Extract the 32-character
encryptKeyfrom the Mi Fitness logs as the pairing key (note: once bound, it cannot be unbound, otherwise the key becomes invalid)Gadgetbridge settings → Automation → Enable Auto-export database
2. Run the MCP Server
# 零依赖,纯标准库
python miband_mcp.py --db /path/to/gadgetbridge.db3. Connect to AI (using Reasonix as an example)
[[plugins]]
name = "miband"
type = "stdio"
command = "python"
args = ["<路径>/miband_mcp.py", "--db", "<路径>/gadgetbridge.db"]
auto_start = trueThen start a new session with /new for it to take effect.
⚠️ Current Limitations
Data synchronization is manual: This project reads the SQLite database snapshot exported by Gadgetbridge and does not automatically pull data from the band.
Current workflow:
Band data is collected by Gadgetbridge (requires prior synchronization)
Manually send the exported database file (
.db) to the computer running miband-mcpAI reads the latest data from the database via MCP tools
Therefore: AI answers based on "the most recently synchronized data", not real-time data. If you need real-time reading, you can combine a Termux script + scheduled synchronization to automatically push the .db file to your computer (this project has not implemented this yet, PRs are welcome).
Development
python -m unittest discover -s tests -v # 34 个测试,零依赖License
MIT © ChenxiDawn · 晨熹
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Hosted Apple Health MCP: workouts, sleep and HRV in ChatGPT, Claude, Gemini, Grok. Free, no export.
Explore Garmin activity and health data with your AI assistant.
Apple Health training load, recovery, HRV and workout detail for Claude, ChatGPT and any MCP client.
Ask Claude, ChatGPT or Cursor about your Apple Health data: workouts, sleep, food. Read-only.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables querying health data from the Health Auto Export app on iPhone/iPad via MCP, allowing LLMs like Claude to access and analyze personal health metrics.68MIT
- AlicenseAqualityAmaintenanceRead-only MCP server that exposes Apple Health data (steps, workouts, sleep, etc.) from a local SQLite store, allowing AI agents to query health metrics without sending data to hosted services.937Apache 2.0
- AlicenseAqualityAmaintenanceProvides local MCP tools to query your own Xiaomi Mi Fitness health data (sleep, workouts, heart rate, etc.) stored in a local SQLite database, enabling AI assistants to access personal health records without exposing credentials.1773AGPL 3.0
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to query health metrics such as activity, blood pressure, glucose, heart rate, sleep, and SpO2 from a PostgreSQL-backed wellness database, returning structured data and summaries through MCP tools.-