Polar Mcp Unofficial

Polar MCP

让你的 AI Agent 在本地使用 Polar Nightly Recharge、训练负荷、PPI 和 HRV 数据。
本地优先的 MCP 服务 — 令牌绝不会离开你的设备。

⚡ 使用 Delx Wellness for Hermes 一键安装： npx -y delx-wellness-hermes setup — 在专用的 Hermes 配置文件中预先配置此连接器和其他 8 个连接器。

也可以将其单独接入 Claude Desktop / Cursor / ChatGPT Desktop — 请参阅下方的安装部分。

---

HTTP（v2 无状态）

默认使用 stdio。可选的 Streamable HTTP — 无会话 ID，返回 JSON，仅限环回地址：

npx -y polar-mcp-unofficial --http
# GET  http://127.0.0.1:3000/health
# POST http://127.0.0.1:3000/mcp   (sessionless)

环境变量：POLAR_MCP_HOST、POLAR_MCP_PORT、POLAR_MCP_TRANSPORT=http。

本地优先的 MCP 服务，可将 AI Agent 连接到 Polar 训练、睡眠、Nightly Recharge 和连续采样数据。

非官方项目。 与 Polar Electro Oy 无关联，也未获得其认可或支持。Polar 是其各自所有者的商标。请仅将此项目用于你自己的 Polar 账户，并遵守 Polar AccessLink API 条款。

由 David Mosiah 为使用 Claude、Cursor、Hermes、OpenClaw 或其他兼容 MCP 的 Agent 来分析训练负荷、恢复和耐力的人打造，无需从 Polar Flow 复制粘贴数据。

这是 Delx Wellness 的一部分，这是一个本地优先的健康类 MCP 连接器目录。

如果此连接器对你的 Agent 工作流有所帮助，请为仓库点个星。星标能让其他 AI 开发者更容易发现此项目，也有助于 Delx 持续构建本地优先的健康基础设施。

为何存在

在消费级可穿戴设备中，Polar 拥有最深入的训练生理数据体系之一，包括 Nightly Recharge、连续采样、PPI（脉搏间期）、训练目标、运动档案、直立测试和体能测试。Polar AccessLink Dynamic API v4 可提供这些数据，但它有 16 个细粒度的 OAuth 权限范围，其结构也比常见的消费级 API 更难浏览。

此软件包在本地处理 OAuth 授权流程，规范化 v4 端点的响应，默认隐藏 GPS 数据，并通过 Model Context Protocol 提供 Polar 服务。令牌不会离开你的设备。

60 秒完成设置

你需要一个 Polar AccessLink 客户端（在此创建），并将重定向 URI 设为 http://127.0.0.1:3000/callback。

npx -y polar-mcp-unofficial setup    # interactive: paste client id + secret
npx -y polar-mcp-unofficial auth     # opens browser, captures the OAuth code
npx -y polar-mcp-unofficial doctor   # verifies you're ready

建议的权限范围（根据你需要的数据申请相应权限）：

activity:read calendar:read continuous_samples:read devices:read
nightly_recharge:read ppi_data:read profile:read routes:read
skin_contact:read sleep:read sports:read temperature_measurement:read
tests:read training_sessions:read training_targets:read user_subscription:read

然后将以下内容添加到 MCP 客户端配置中：

{
  "mcpServers": {
    "polar": {
      "command": "npx",
      "args": ["-y", "polar-mcp-unofficial"]
    }
  }
}

对于 Claude Desktop，运行 setup --client claude，系统会为你写入配置片段。

用你的 Agent 试试看

先问以下三个问题：

Use polar_connection_status to check setup, then run polar_daily_summary.
Give me a 5-line training brief for today.

Call polar_weekly_summary with response_format=json. Identify my biggest
training-load/recovery bottleneck and give me a next-week plan.

Use the polar_training_load_investigation prompt, after=2026-04-01.
Walk me through my recent training sessions + Nightly Recharge.

数据可用性

此软件包使用官方的 Polar AccessLink Dynamic API v4。本 README 中的 raw 指受支持端点的上游 Polar JSON，而不是设备传感器的原始数据流。

数据	可用性	说明
每日活动 + 日历	是	需要 activity:read / calendar:read
睡眠 + 睡眠/唤醒向量	是	需要 sleep:read
Nightly Recharge（恢复评分）	是	需要 nightly_recharge:read；仅限受支持的设备
训练课程 + 训练目标	是	需要 training_sessions:read / training_targets:read
连续采样（随时间变化的 HR）	是	需要 continuous_samples:read
PPI 采样（脉搏间期，与 HRV 相关）	是	需要 ppi_data:read；仅限受支持的设备
温度测量	是	需要 temperature_measurement:read；仅限受支持的设备
皮肤接触时段	是	需要 skin_contact:read
测试（体能 / 直立 / 跑步）	是	需要 tests:read
路线 + GPS 几何数据	可选启用	除非使用原始模式，否则会隐藏 GPS 坐标
运动 + 运动档案 + 设备	是	目录和用户元数据
设备实时遥测数据	-	Polar AccessLink 不提供

工具

从这些工具开始：

• polar_quickstart - 个性化的 3 步设置向导，会根据已完成的配置进行调整
• polar_connection_status - 在调用 Polar 前验证本地设置、权限范围和就绪状态
• polar_data_inventory — 列出支持的数据领域、权限范围、隐私模式和建议的首次调用，不调用 Polar API。
• polar_demo - 合成示例载荷，让 Agent 在调用真实 API 前了解数据约定
• polar_daily_summary - 今日的睡眠、活动、Nightly Recharge 和训练简报
• polar_weekly_summary - 记分卡、与上周的比较以及下周计划
• polar_wellness_context - 以共享的 wellness_context 结构提供 Nightly Recharge、睡眠和训练负荷

身份验证与诊断

• polar_capabilities、polar_agent_manifest、polar_privacy_audit、polar_cache_status
• polar_get_auth_url、polar_exchange_code、polar_revoke_access

账户

• polar_get_account_data、polar_list_user_devices、polar_list_subscriptions

共享健康档案（本地数据，绝不包含 Polar 数据）

• polar_onboarding、polar_profile_get、polar_profile_update — 与其他连接器共享的 Delx Wellness 档案；只存储用户输入的内容，绝不存储令牌或生物标志物

活动与睡眠

• polar_list_activity、polar_list_calendar
• polar_list_sleeps、polar_list_sleep_wake_vectors — 睡眠列表默认会使用 v4 的 sleep-result、sleep-evaluation 和 sleep-score 功能填充可用日期

心率与生理指标（日期范围）

• polar_heart_series — 来自连续样本、受范围限制的 agent-safe-series/v1 心率数据（建议 Agent 使用此工具）
• polar_list_continuous_samples、polar_list_ppi_samples
• polar_list_temperature_measurements、polar_list_skin_contacts

训练

• polar_list_training_sessions、polar_list_training_targets、polar_list_training_target_favorites
• polar_list_tests

运动与路线

• polar_list_sports、polar_list_sport_profile_catalog、polar_list_sport_profiles
• polar_get_route - 除非使用 raw 模式，否则会隐藏 GPS 坐标

提示词

• polar_daily_checkin - 实用的每日训练与恢复检查
• polar_weekly_review - 回顾活动、睡眠和恢复趋势
• polar_training_load_investigation - 调查训练课程及恢复情况

资源

• polar://capabilities、polar://agent-manifest、polar://inventory
• polar://summary/daily、polar://summary/weekly
• polar://account-data、polar://latest/sleep

隐私与安全

• OAuth 令牌存储在 ~/.polar-mcp/tokens.json 中，权限为 0600，工具绝不会返回这些令牌。
• 服务绝不会打印访问令牌或刷新令牌。
• POLAR_PRIVACY_MODE 默认值为 structured。Structured 模式会保留完整的上游生理数据载荷，同时移除机密字段和 GPS 字段；规范化别名是附加信息，绝不会替换嵌套的 v4 对象。只有选择 raw 模式或对单次调用进行覆盖时，才会提供 Polar 原始 JSON。
• 在 summary 和 structured 模式下会隐藏 GPS 路线几何信息；只有 raw 模式会公开原始坐标。
• 每个端点都会验证日期格式和支持的 features。对于 Polar 限制为单日的功能查询，会逐个可用日期填充数据。
• MCP 客户端看不到访问令牌或刷新令牌。
• 这不是医疗建议。 服务提供用户授权的数据，供个人 AI 工作流使用，不用于诊断或开具训练计划。

配置

setup 会将其中大多数配置写入 ~/.polar-mcp/config.json（权限为 0600）。支持手动设置环境变量覆盖：

POLAR_CLIENT_ID=<client-id>
POLAR_CLIENT_SECRET=<client-secret>
POLAR_REDIRECT_URI=http://127.0.0.1:3000/callback

# Optional
POLAR_SCOPES="activity:read calendar:read continuous_samples:read ..."
POLAR_PRIVACY_MODE=structured        # summary | structured | raw
POLAR_CACHE=sqlite                   # optional read-through cache
POLAR_TOKEN_PATH=~/.polar-mcp/tokens.json
POLAR_CACHE_PATH=~/.polar-mcp/cache.sqlite

Hermes / 远程设置

npx -y polar-mcp-unofficial setup --client hermes --no-auth
npx -y polar-mcp-unofficial auth                      # run locally if browser auth is needed
npx -y polar-mcp-unofficial doctor --client hermes
hermes mcp test polar

修改 Hermes 配置后，请使用 /reload-mcp 或 hermes mcp test polar。正常访问数据时无需重启网关。

如果浏览器 OAuth 必须在与 Hermes 不同的机器上进行，请在本地运行 auth，然后将 ~/.polar-mcp/tokens.json 复制到服务器，并设置 chmod 600。

要求

• Node.js 20+
• 在 https://admin.polaraccesslink.com 注册的 Polar AccessLink 客户端，重定向 URI 为 http://127.0.0.1:3000/callback

开发

git clone https://github.com/davidmosiah/polar-mcp.git
cd polar-mcp
npm install
npm test
npm run build

使用 MCP Inspector 测试：

npx @modelcontextprotocol/inspector node dist/index.js

链接

• npm：https://www.npmjs.com/package/polar-mcp-unofficial
• 文档站点：https://wellness.delx.ai/connectors/polar
• 旧版文档：https://polarmcp.vercel.app/
• GitHub：https://github.com/davidmosiah/polar-mcp
• Delx Wellness 注册表：https://github.com/davidmosiah/delx-wellness
• 连接器质量标准：https://github.com/davidmosiah/delx-wellness/blob/main/docs/connector-quality-standard.md
• Polar AccessLink Dynamic API v4 文档：https://www.polar.com/polar-api-v4/

另请参阅

完整的 Delx Wellness 连接器库：

提供商	包	仓库
WHOOP	whoop-mcp-unofficial	whoop-mcp
Oura	oura-mcp-unofficial	ouramcp
Garmin	garmin-mcp-unofficial	garminmcp
Strava	strava-mcp-unofficial	strava-mcp
Fitbit	fitbit-mcp-unofficial	fitbitmcp
Withings	withings-mcp-unofficial	withingsmcp
Apple Health	apple-health-mcp-unofficial	apple-health-mcp
Polar	polar-mcp-unofficial	polar-mcp
Nourish（营养）	wellness-nourish	wellness-nourish

Hermes 一键设置 — 预配置以上所有连接器，以及健康技能和入门引导：delx-wellness-hermes。

📧 联系与支持

• 📨 [email protected] — 一般问题、集成帮助、合作事宜
• 🐛 错误报告／功能请求 — GitHub Issues
• 🐦 更新 — X 上的 @delx369
• 🌐 网站 — wellness.delx.ai

许可证

MIT — 参见 LICENSE。

免责声明

本软件按“原样”提供。它不是医疗器械，不提供医疗建议，不应用于诊断、治疗或训练方案制定。如有医疗或训练方面的疑虑，请务必咨询合格的专业人士。

Skill 或 MCP

同一个包，两种使用方式。MCP 通过 stdio/HTTP 注册工具。当客户端不支持 MCP 时，skill 可通过 CLI 调用同一批工具：

npx -y polar-mcp-unofficial call polar_connection_status --json '{}'

将 skill/SKILL.md 复制到你的 Agent 技能目录中。