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
安装
npx wrangler kv namespace create OAUTH_KV配置
{
"mcpServers": {
"polar": {
"command": "node",
"args": ["/path/to/polar-mcp-server/dist/index.js"],
"env": {
"POLAR_ACCESS_TOKEN": "your_access_token"
}
}
}
}