davidmosiah avatar

Polarmcp

davidmosiah/polar-mcp

Connects AI agents to Polar wearable data through the AccessLink v4 API. Handles OAuth locally so tokens never leave your machine. Exposes 16 fine-grained scopes covering Nightly Recharge, training load, sleep, HRV, PPI samples, continuous heart rate, fitness tests, and training sessions. GPS coordinates are redacted by default. Ships with tools like polar_daily_summary and polar_weekly_summary for quick recovery and training briefs, plus granular methods for pulling continuous samples, sleep wake vectors, and orthostatic test results. Run npx polar-mcp-unofficial setup to configure your AccessLink client, then auth to complete the OAuth flow. Useful if you're coaching yourself with Claude and want structured physiology data without copy-pasting from Polar Flow.

GitHub stars
6
tools
38
auth
Secret needed
transport
STDIO
env vars
8
last updated
Jul 13, 2026

Tools

38 tools

Public tool metadata for what this MCP can expose to an agent.

polar_quickstartpersonalized 3-step setup walkthrough that adapts to what's already configured

personalized 3-step setup walkthrough that adapts to what's already configured

No parameter schema in public metadata yet.

polar_connection_statusverify local setup, scopes and readiness before calling Polar

verify local setup, scopes and readiness before calling Polar

No parameter schema in public metadata yet.

polar_data_inventoryinventory supported data domains, scopes, privacy modes and recommended first calls without calling Polar APIs.

inventory supported data domains, scopes, privacy modes and recommended first calls without calling Polar APIs.

No parameter schema in public metadata yet.

polar_demosynthetic example payloads so agents see the contract before calling the real API

synthetic example payloads so agents see the contract before calling the real API

No parameter schema in public metadata yet.

polar_daily_summarysleep, activity, Nightly Recharge and training brief for today

sleep, activity, Nightly Recharge and training brief for today

No parameter schema in public metadata yet.

polar_weekly_summaryscorecard, comparison vs prior week, next-week plan

scorecard, comparison vs prior week, next-week plan

No parameter schema in public metadata yet.

polar_wellness_contextNightly Recharge, sleep and training load in the shared `wellness_context` shape

Nightly Recharge, sleep and training load in the shared `wellness_context` shape

No parameter schema in public metadata yet.

polar_capabilities

No parameter schema in public metadata yet.

polar_agent_manifest

No parameter schema in public metadata yet.

polar_privacy_audit

No parameter schema in public metadata yet.

polar_cache_status

No parameter schema in public metadata yet.

polar_get_auth_url

No parameter schema in public metadata yet.

polar_exchange_code

No parameter schema in public metadata yet.

polar_revoke_access

No parameter schema in public metadata yet.

polar_get_account_data

No parameter schema in public metadata yet.

polar_list_user_devices

No parameter schema in public metadata yet.

polar_list_subscriptions

No parameter schema in public metadata yet.

polar_onboardingthe Delx Wellness profile shared with the other connectors; stores only what the user typed, never tokens or biomarkers

the Delx Wellness profile shared with the other connectors; stores only what the user typed, never tokens or biomarkers

No parameter schema in public metadata yet.

polar_profile_getthe Delx Wellness profile shared with the other connectors; stores only what the user typed, never tokens or biomarkers

the Delx Wellness profile shared with the other connectors; stores only what the user typed, never tokens or biomarkers

No parameter schema in public metadata yet.

polar_profile_updatethe Delx Wellness profile shared with the other connectors; stores only what the user typed, never tokens or biomarkers

the Delx Wellness profile shared with the other connectors; stores only what the user typed, never tokens or biomarkers

No parameter schema in public metadata yet.

polar_list_activity

No parameter schema in public metadata yet.

polar_list_calendar

No parameter schema in public metadata yet.

polar_list_sleepssleep lists hydrate available dates with the v4 `sleep-result`, `sleep-evaluation`, and `sleep-score` features by default

sleep lists hydrate available dates with the v4 `sleep-result`, `sleep-evaluation`, and `sleep-score` features by default

No parameter schema in public metadata yet.

polar_list_sleep_wake_vectorssleep lists hydrate available dates with the v4 `sleep-result`, `sleep-evaluation`, and `sleep-score` features by default

sleep lists hydrate available dates with the v4 `sleep-result`, `sleep-evaluation`, and `sleep-score` features by default

No parameter schema in public metadata yet.

polar_list_nightly_recharge

No parameter schema in public metadata yet.

polar_heart_seriesagent-safe-series/v1 bounded HR from continuous samples (prefer this for agents)

agent-safe-series/v1 bounded HR from continuous samples (prefer this for agents)

No parameter schema in public metadata yet.

polar_list_continuous_samples

No parameter schema in public metadata yet.

polar_list_ppi_samples

No parameter schema in public metadata yet.

polar_list_temperature_measurements

No parameter schema in public metadata yet.

polar_list_skin_contacts

No parameter schema in public metadata yet.

polar_list_training_sessions

No parameter schema in public metadata yet.

polar_list_training_targets

No parameter schema in public metadata yet.

polar_list_training_target_favorites

No parameter schema in public metadata yet.

polar_list_tests

No parameter schema in public metadata yet.

polar_list_sports

No parameter schema in public metadata yet.

polar_list_sport_profile_catalog

No parameter schema in public metadata yet.

polar_list_sport_profiles

No parameter schema in public metadata yet.

polar_get_routeGPS coordinates redacted unless raw mode

GPS coordinates redacted unless raw mode

No parameter schema in public metadata yet.

Sponsors

Configuration

POLAR_CLIENT_ID

Polar OAuth client ID. Optional when configured with polar-mcp-server setup.

POLAR_CLIENT_SECRETsecret

Polar OAuth client secret. Prefer polar-mcp-server setup so this secret is stored in ~/.polar-mcp/config.json instead of MCP client config.

POLAR_REDIRECT_URI

Redirect URI configured in the Polar AccessLink admin. Optional when configured with polar-mcp-server setup.

POLAR_TOKEN_PATH

Optional local path for OAuth tokens. Defaults to ~/.polar-mcp/tokens.json.

POLAR_PRIVACY_MODE

Optional payload mode: summary, structured, or raw. Defaults to structured. raw means full Polar AccessLink payloads for supported endpoints.

POLAR_CACHE

Optional SQLite cache toggle. Set to true or sqlite to enable.

POLAR_CACHE_PATH

Optional local SQLite cache path. Defaults to ~/.polar-mcp/cache.sqlite.

POLAR_NO_CACHE

Set to true to bypass the in-memory HTTP response cache (60s TTL for GET only). POST/PUT/DELETE and 4xx/5xx responses are never cached regardless.

Readme

Upgrading to 0.6.0: read the migration guide for local-only HTTP, disabled authenticated-response caching, and stricter input/profile limits.

Polar MCP

Polar MCP — Polar MCP for AI agents

Give your AI agent your Polar Nightly Recharge, training load, PPI and HRV data — locally.
Local-first MCP server — tokens never leave your machine.


View the full README on GitHub

Details

Repository
github.com/davidmosiah/polar-mcp
Website
wellness.delx.ai/connectors/polar
Package
polar-mcp-unofficial
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from davidmosiah