Skip to main content
Glama
binglua

Mi Fitness MCP CN

by binglua

Mi Fitness MCP CN

小米运动健康 / Mi Fitness 数据本地 MCP Server。

本项目基于 kubulashvili/mi-fitness-mcp 修改,增加中国区小米健康云适配,并补充睡眠与运动记录同步能力。

非小米官方项目,仅用于读取和分析你自己的健康数据。数据默认同步到本地 SQLite。

功能

  • 读取小米运动健康云端数据

  • 本地 SQLite 缓存

  • MCP Server 支持

  • 支持中国区:--region cn

  • 支持数据类型:

    • daily_activity:步数、距离、活动卡路里

    • heart_rate:心率采样

    • sleep:睡眠记录

    • workouts:运动记录

    • body_measurements:体重 / 身体成分,视账号数据而定

Related MCP server: Mi Fitness MCP

已逆向验证的接口

健康数据接口

POST https://hlth.io.mi.com/app/v1/data/get_fitness_data_by_time

常用 key:

steps
calories
heart_rate
weight
sleep

睡眠请求示例:

{
  "start_time": 1767225600,
  "end_time": 1782086399,
  "key": "sleep"
}

运动记录接口

POST https://hlth.io.mi.com/app/v1/data/get_sport_records_by_time

请求示例:

{
  "start_time": 1767225600,
  "end_time": 1782086399,
  "limit": 50
}

返回字段通常包含:

sport_records
has_more
next_key

每条运动记录的 value 是 JSON 字符串,包含 start_timeend_timedurationdistancecaloriesavg_hrmmax_hrm 等字段。

安装

git clone git@github.com:binglua/mi-fitness-mcp-cn.git
cd mi-fitness-mcp-cn
python -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'

如果当前环境没有系统 keyring,可安装:

pip install keyrings.alt

注意:keyrings.alt 可能以明文文件方式保存凭据。

配置

需要从 https://account.xiaomi.com 登录后的 Cookie 中获取:

  • userId

  • passToken

中国区账号建议:

mi-fitness-mcp setup \
  --mode mi_fitness_cloud \
  --user-id "<userId>" \
  --pass-token "<passToken>" \
  --region cn

检查连接:

mi-fitness-mcp doctor

同步数据

同步全部可探测数据:

mi-fitness-mcp sync --start-date 2026-01-01 --end-date 2026-06-21

按类型同步:

mi-fitness-mcp sync --type daily_activity --start-date 2026-01-01 --end-date 2026-06-21
mi-fitness-mcp sync --type heart_rate --start-date 2026-01-01 --end-date 2026-06-21
mi-fitness-mcp sync --type sleep --start-date 2026-01-01 --end-date 2026-06-21
mi-fitness-mcp sync --type workouts --start-date 2026-01-01 --end-date 2026-06-21
mi-fitness-mcp sync --type body_measurements --start-date 2026-01-01 --end-date 2026-06-21

启动 MCP Server

mi-fitness-mcp serve

Claude Desktop 配置示例:

{
  "mcpServers": {
    "mi-fitness": {
      "command": "mi-fitness-mcp",
      "args": ["serve"]
    }
  }
}

MCP 工具

  • get_connection_status

  • sync_data

  • get_profile

  • get_daily_summary

  • query_metric_series

  • query_heart_rate

  • query_body_measurements

  • query_sleep

  • query_workouts

  • get_data_coverage

本地数据库

默认位置:

~/.local/share/mi-fitness-mcp/mi_fitness.db

主要表:

daily_activity
heart_rate_samples
sleep_sessions
workouts
body_measurements
sync_state

安全说明

  • passToken 是敏感凭据,不要泄露。

  • 不要提交本地配置、数据库、keyring 文件。

  • 如果 token 泄露,建议退出小米账号并重新登录刷新。

免责声明

本项目与小米公司无关。请仅用于读取和分析你自己的健康数据。

新增健康指标

本分支额外逆向并验证了以下小米运动健康云端 key,并已接入 CLI 同步、本地 SQLite 缓存和 MCP 查询工具:

  • resting_heart_rate:静息心率,合并到 query_heart_rate(sample_type="resting")

  • spo2:血氧饱和度,CLI 类型 spo2,MCP 工具 query_spo2

  • stress:压力值,CLI 类型 stress,MCP 工具 query_stress

  • abnormal_heart_beat:异常心跳事件,CLI 类型 abnormal_heart_beat,MCP 工具 query_abnormal_heart_beat

示例:

mi-fitness-mcp sync --type spo2 --start-date 2026-06-01 --end-date 2026-06-22
mi-fitness-mcp sync --type stress --start-date 2026-06-01 --end-date 2026-06-22
mi-fitness-mcp sync --type abnormal_heart_beat --start-date 2026-06-01 --end-date 2026-06-22

License

MIT

Available Tools

10 tools
get_connection_statusB

Check connection status

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided. Description doesn't disclose whether the check is local or remote, possible states, or side effects. Minimal transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Extremely concise, front-loaded, no wasted words. Every word earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite no parameters or annotations, the description fails to explain the meaning of 'connection status' or expected return values. Incomplete for a tool without an output schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

No parameters, so schema coverage is 100%. Description adds no extra meaning but baseline is 4 for zero parameters.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Clearly states the verb 'check' and the resource 'connection status'. Distinguishes from sibling tools which focus on data retrieval or summaries.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives. For a simple status check, implied usage is before other operations, but not explicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_daily_summaryD

Get daily activity summary

ParametersJSON Schema
NameRequiredDescriptionDefault
dateNo
start_dateNo
end_dateNo

TDQS

D1.7/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, and the description does not disclose any behavioral traits such as read-only nature, side effects, or rate limits. The description fails to compensate for the lack of annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness1/5

Is the description appropriately sized, front-loaded, and free of redundancy?

While the description is short, it is underspecified. Conciseness should not sacrifice useful information; here, a single sentence provides no context and fails to earn its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the three parameters, no output schema, and no annotations, the description is severely incomplete. It does not explain what data the summary returns, how date ranges work, or any other essential details for an agent to use the tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, and the description adds no meaning beyond the parameter names and types. The parameters 'date', 'start_date', and 'end_date' are not explained in terms of format, required combinations, or relationships.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Get daily activity summary' specifies a verb and resource, but it is vague. It does not clarify what the summary contains or how it differs from sibling tools like query_body_measurements or query_heart_rate, which also retrieve activity data.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. There is no mention of prerequisites, when-not-to-use, or comparison with other tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_data_coverageD

Get data coverage

ParametersJSON Schema
NameRequiredDescriptionDefault
data_typesNo

TDQS

D1.5/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are present, and the description fails to disclose any behavioral traits such as read-only nature, required permissions, or return behavior. The agent has no insight into side effects or prerequisites.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is only three words, which is under-specified rather than concise. It does not provide enough information to be useful, failing the 'every sentence earns its place' criterion.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no annotations, no output schema, and a single parameter with no description, the tool description is entirely inadequate. The agent cannot correctly understand or invoke the tool based on this definition.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, yet the description does not explain the 'data_types' parameter. There is no information on valid values, defaults, or how the parameter affects results.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Get data coverage' is a tautology, merely restating the tool name without clarifying what 'data coverage' means or what data it covers.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus siblings like query_heart_rate or sync_data. The description offers no context for selection.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_profileB

Get user profile information

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must convey behavioral traits. It only states the function without disclosing whether it is a read operation, requires authentication, or has rate limits. The term 'Get' implies reading, but this is not explicit.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, direct sentence with no wasted words. It is appropriately sized for a simple tool with no parameters.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has no parameters and no output schema, the description is minimal but functional. However, it lacks any detail about what profile information is returned (e.g., name, email, settings), which could help an agent anticipate output. A bit more context would improve completeness.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has no parameters, and schema description coverage is 100% (trivially). For zero-parameter tools, the baseline is 4, and the description does not need to add parameter info. It does not detract from understanding.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states a specific verb ('Get') and resource ('user profile information'), making the tool's purpose immediately understandable. It distinguishes from siblings like 'get_connection_status' or 'get_daily_summary' by focusing on profile data. However, it could be more precise (e.g., 'current authenticated user's profile').

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives, such as other query tools like 'query_body_measurements'. No mention of context, prerequisites, or exclusions is given.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

query_body_measurementsC

Query body measurements

ParametersJSON Schema
NameRequiredDescriptionDefault
start_dateYes
end_dateYes
metricsNo
latest_onlyNo

TDQS

C2.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided. Description only says 'query', suggesting read-only, but lacks details on response format, pagination, or what happens when no data exists.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single sentence is concise but under-specified. Lacks structure; could be expanded without losing conciseness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 4 parameters, no output schema, and many sibling tools, description is incomplete. No info about return values or when to use this tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 0%, so description must compensate. It does not mention any parameter (e.g., date format, meaning of latest_only, or the metrics enum). Schema is somewhat self-documenting but insufficient.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description 'Query body measurements' is a tautology of the name. It does not specify what body measurements or distinguish from sibling tools like query_heart_rate or query_metric_series.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives. No context about prerequisites or constraints.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

query_heart_rateC

Query heart rate samples

ParametersJSON Schema
NameRequiredDescriptionDefault
start_dateYes
end_dateYes
sample_typeNo
limitNo

TDQS

C2.1/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations exist, and the description gives no behavioral details. It does not indicate read/write behavior, destructive potential, or any constraints like date format or rate limits. The agent gets no insight into side effects or permissions.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

While the description is short (one sentence), it is under-specified rather than concise. It front-loads the verb but omits critical context, making it less useful than a slightly longer but more informative description would be.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has 4 parameters (2 required, one with enum) and no output schema, the description is woefully incomplete. It does not explain return format, filtering behavior, or the meaning of 'samples,' leaving significant gaps for an AI agent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 0% schema description coverage, the description must compensate, but it does not. It fails to mention any of the four parameters (start_date, end_date, sample_type, limit) or their meanings. The agent cannot infer valid values or usage patterns from the description alone.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Query heart rate samples' clearly identifies the verb (query) and resource (heart rate samples). However, it does not differentiate from sibling tools like query_body_measurements or query_sleep, which have similar names. It is clear but lacks specificity about what 'samples' entails.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. For example, it does not clarify if this is appropriate for real-time queries or historical analysis compared to other data query tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

query_metric_seriesD

Query metric series

ParametersJSON Schema
NameRequiredDescriptionDefault
metricYes
start_dateYes
end_dateYes
granularityNo
aggregationNo

TDQS

D1/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are present, so the description carries full burden for behavioral disclosure. It mentions no behavioral traits such as read-only nature, authentication requirements, rate limits, or data aggregation behavior. This is a critical omission.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness1/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is under-specified and fails to earn its place. It conveys no useful information beyond the name, which is already present in the tool name itself.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity (5 parameters, 3 enums, no output schema), the description is completely inadequate. It provides no context on return values, date formatting, or how aggregation interacts with granularity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 0% description coverage, and the description adds no parameter explanations. Parameters like start_date format, granularity meaning, and aggregation options are left unspecified, making correct invocation guesswork.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose1/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Query metric series' is a tautology that merely restates the tool name. It fails to specify that the tool retrieves time-series health metrics like steps, distance, or calories, nor does it differentiate from sibling tools like query_heart_rate or query_sleep.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. With sibling tools dedicated to specific metrics, the description should clarify that this tool handles generic metric series and should be used when the desired metric is not covered by a specialized tool.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

query_sleepC

Query sleep sessions

ParametersJSON Schema
NameRequiredDescriptionDefault
start_dateYes
end_dateYes
include_napsNo

TDQS

C2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description does not disclose any behavioral traits such as read-only nature, rate limits, or pagination. With no annotations, the description carries the full burden but provides no behavioral context beyond the basic operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is too sparse to be useful. While concise, it lacks essential details and does not front-load key information, making it inadequate for an agent to understand the tool.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has 3 parameters (2 required), no output schema, and no annotations, the description is highly incomplete. It does not explain output format, filtering behavior, or parameter constraints, leaving critical gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 0% description coverage, and the description adds no meaning to the parameters. It fails to explain the purpose of 'start_date', 'end_date', or 'include_naps', including expected formats or effects.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states 'Query sleep sessions', which identifies the verb and resource but lacks specificity about the scope or what exactly constitutes a 'sleep session'. It distinguishes from sibling tools like 'query_workouts' but is still vague.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided about when to use this tool versus alternatives. There is no mention of use cases, prerequisites, or when to avoid this tool.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

query_workoutsD

Query workouts

ParametersJSON Schema
NameRequiredDescriptionDefault
start_dateYes
end_dateYes
activity_typesNo
min_durationNo
min_distance_kmNo

TDQS

D1/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations and a one-word description, the tool's behavioral impact is completely opaque. The agent cannot determine if this is a read-only operation, what data is returned, or any side effects.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness1/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is under-specified rather than concise. A single sentence that adds no value beyond the tool name is not a virtue; it omits critical information the agent needs.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 5 parameters, 2 required, and no output schema, the description fails to provide enough context for correct invocation. The agent cannot know what response to expect or how to handle errors.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0% and the description adds no information about parameters like start_date, end_date, activity_types, etc. The agent has to guess their formats, constraints, and meanings from the schema alone, which is insufficient.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose1/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Query workouts' is a tautology that merely restates the tool name without specifying what exactly is queried, what filtering capabilities exist, or how it differs from sibling query tools like query_heart_rate or query_sleep.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives no indication of when to use this tool versus alternatives. There is no guidance on prerequisites, expected usage context, or typical scenarios where this tool is appropriate.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

sync_dataD

Synchronize Mi Fitness data

ParametersJSON Schema
NameRequiredDescriptionDefault
data_typesNo
start_dateNo
end_dateNo
force_full_syncNo

TDQS

D1.3/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided. Description fails to disclose any behavioral traits: side effects, destructive nature, required connectivity, or whether it overwrites data. For a sync tool, this is a critical gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single sentence is concise but under-specified. The brevity is not efficient because it omits essential information; it is merely short.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With 4 parameters, no output schema, and no annotations, the description is severely incomplete. Missing information about data types, date formats, sync mechanics, and expected outcomes makes the tool unsafe and unusable for an AI agent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%. Description says nothing about what 'data_types', 'start_date', 'end_date', or 'force_full_sync' represent, format requirements, or default behavior. Adds zero value beyond schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description states 'Synchronize Mi Fitness data', which is a tautology. It does not distinguish the tool from siblings (all get/query tools), nor does it specify what synchronization entails (push/pull/bidirectional). Minimal purpose clarity.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool vs alternatives. No context about prerequisites, ideal invocation timing, or scenarios where sync is appropriate. Completely absent.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 10 tool updatesv0.1.0
    • First observedget_connection_status
    • First observedget_daily_summary
    • First observedget_data_coverage
    • First observedget_profile
    • First observedquery_body_measurements
    • First observedquery_heart_rate
    • First observedquery_metric_series
    • First observedquery_sleep
    • First observedquery_workouts
    • First observedsync_data

TDQS

C2.5/5.0
Disambiguation5/5

Each tool targets a distinct aspect of fitness data (e.g., connection, daily summary, heart rate, sleep, workouts), with no overlapping purposes. Agents can easily differentiate them.

Naming Consistency5/5

All tools follow a consistent verb_noun pattern (get_/query_/sync_) with clear prefixes for type of operation, making them predictable and easy to navigate.

Tool Count5/5

10 tools is well-scoped for a fitness data server, covering essential data types without being overwhelming or too sparse.

Completeness4/5

The tool set covers core fitness data areas (profile, activity, sleep, heart rate, workouts) and includes sync functionality. Minor gaps like nutrition or stress data exist, but the surface is largely complete for typical use.

Maintenance

ActivitySlowing
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    B
    maintenance
    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.
    10
    9
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Self-hosted MCP server that syncs Xiaomi fitness data to SQLite and provides authenticated tools to query health metrics (steps, sleep, HR, etc.) for AI assistants like Grok.
    GPL 3.0
  • A
    license
    C
    quality
    A
    maintenance
    Provides 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.
    15
    11
    AGPL 3.0

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/binglua/mi-fitness-mcp-cn'

If you have feedback or need assistance with the MCP directory API, please join our Discord server