nelsonnew/polar-mcp-server

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

6 stars 6 forks 品質 64 トレンド 18

Repository Install

A Model Context Protocol (MCP) server that provides AI assistants with access to the Polar AccessLink API v3

概要

An MCP (Model Context Protocol) server for the Polar AccessLink API. Connect your Polar fitness data to Claude AI - access workouts, sleep analysis, recovery metrics, heart rate data, and more. 1. In Claude: 2. Enter the URL: https://polar-mcp-server.n-neuhaeusel.workers.dev/mcp 3. Claude will open an authorization window — log in with your Polar account 4. Start chatting about your fitness data! - Polar Pacer / Pacer Pro - Polar Vantage V2 / V3 - Polar Vantage M / M2 - Polar Grit X / Grit X Pro / Grit X2 Pro - Polar Ignite / Ignite 2 / Ignite 3 - Polar Unite - And more... - "Show me my workouts from last week" - "How was my sleep last night? Compare it to my weekly average" - "Analyze my heart rate variability trends" - "What's my current training load status?" - "When should I go to bed tonight for optimal recovery?" - "Export my last run as a GPX file" - "How many steps did I take this month?" Want to run your own instance?

README

以下は原文 README の抜粋です。原文を見る。

Polar MCP Server

An MCP (Model Context Protocol) server for the Polar AccessLink API. Connect your Polar fitness data to Claude AI - access workouts, sleep analysis, recovery metrics, heart rate data, and more.

Quick Start (Public Instance)

No setup required! Use our hosted instance:

In Claude: Settings → Integrations → Add MCP Server
Enter the URL: https://polar-mcp-server.n-neuhaeusel.workers.dev/mcp
Claude will open an authorization window — log in with your Polar account
Start chatting about your fitness data!

Features

25 Tools Available

Category	Tools	Description
Exercises	`get_exercises`, `get_exercise`	Training data with HR, speed, zones
Exercise Export	`get_exercise_fit`, `get_exercise_tcx`, `get_exercise_gpx`	Export in FIT, TCX, GPX formats
Sleep	`get_sleep`, `get_sleep_range`	Sleep stages, score, duration
Recovery	`get_nightly_recharge`, `get_nightly_recharge_range`	ANS charge, HRV, breathing rate
Activity	`get_daily_activity`, `get_daily_activity_range`, `get_activity_samples`, `get_activity_samples_range`	Steps, calories, activity zones
Heart Rate	`get_continuous_heart_rate`, `get_continuous_heart_rate_range`	24/7 heart rate monitoring
Training Load	`get_cardio_load`, `get_cardio_load_range`, `get_cardio_load_history`	TRIMP, acute/chronic load
SleepWise	`get_sleepwise_alertness`, `get_sleepwise_circadian_bedtime`	Alertness predictions, optimal bedtime
Biosensing	`get_body_temperature`, `get_skin_temperature`, `get_spo2`	Temperature, SpO2 data
User	`get_user_info`, `get_physical_info`	Profile, VO2max, resting HR

Supported Devices

Polar Pacer / Pacer Pro
Polar Vantage V2 / V3
Polar Vantage M / M2
Polar Grit X / Grit X Pro / Grit X2 Pro
Polar Ignite / Ignite 2 / Ignite 3
Polar Unite
And more…

Example Prompts

Once connected, ask Claude:

“Show me my workouts from last week”
“How was my sleep last night? Compare it to my weekly average”
“Analyze my heart rate variability trends”
“What’s my current training load status?”
“When should I go to bed tonight for optimal recovery?”
“Export my last run as a GPX file”
“How many steps did I take this month?”

Self-Hosting

Want to run your own instance? Two deployment options available:

Option 1: Cloudflare Workers (Recommended)

Prerequisites

Cloudflare account
Polar AccessLink API credentials

Setup

# Clone and install
git clone https://github.com/NelsonNew/polar-mcp-server.git
cd polar-mcp-server
npm install

# Create KV namespace
npx wrangler kv namespace create OAUTH_KV
# Copy the ID to wrangler.toml

# Set secrets
npx wrangler secret put POLAR_CLIENT_ID
npx wrangler secret put POLAR_CLIENT_SECRET

# Deploy
npm run deploy

GitHub で README 全文を見る

インストール

npx wrangler kv namespace create OAUTH_KV

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "polar": {
      "command": "node",
      "args": ["/path/to/polar-mcp-server/dist/index.js"],
      "env": {
        "POLAR_ACCESS_TOKEN": "your_access_token"
      }
    }
  }
}