Read-only OAuth · local tokens · AccessLink v4

Polar AccessLink, packaged for agent workflows.

Polar MCP is an unofficial, open-source bridge that gives AI agents safe access to user-authorized Polar activity, sleep, Nightly Recharge, training, routes, samples, devices and tests through the official AccessLink Dynamic API v4.

npx -y polar-mcp-unofficial setup
30tools
Sleep7h 10msummary context
Rechargegoodtrend, not diagnosis
Training1 sessionload + recovery
Official APIPolar AccessLink v4 OAuth2
Local-firsttokens under ~/.polar-mcp
30 toolsactivity, sleep, training, routes
Agent-readyClaude, Cursor, Hermes, OpenClaw

For humans

No API archaeology. No token pasted into agent configs.

Polar developer setup is the hard part. This page gives the exact callback, scopes and commands so a non-technical user can delegate the install safely.

01

Create your Polar client

Open the Polar AccessLink admin and add this callback URL.

http://127.0.0.1:3000/callback
Open Polar AccessLink
03

Run setup

npx -y polar-mcp-unofficial setup
npx -y polar-mcp-unofficial auth
npx -y polar-mcp-unofficial doctor

The toolbelt

Polar signals, shaped for agents.

Activitydaily activity, steps, calories and calendar context
Sleepsleeps, sleep/wake vectors and Nightly Recharge
Trainingsessions, targets, sports and sport profiles
Samplescontinuous samples, PPI, temperature and skin contact
Routesroute data is GPS-sensitive and redacted by default

For agents

A manifest that tells agents how not to break things.

Agents should call polar_agent_manifest and polar_connection_status first. Hermes gets direct tool names and explicit reload guidance so it does not restart the gateway for normal Polar access.

Install the unofficial Polar MCP server for me.
Repo: github.com/davidmosiah/polarmcp
Callback: http://127.0.0.1:3000/callback
Then run setup, auth and doctor.
Keep tokens local. No medical diagnosis.

Trust boundary

Health and route data are not toy payloads.

This MCP exposes Polar AccessLink Dynamic API v4 data. It does not call private Polar Flow mobile endpoints, write data, or provide clinical diagnosis. Raw JSON is explicit; summary and structured modes are safer defaults.

summaryminimal safe fields
structurednormalized agent data
rawexplicit upstream JSON
0600local token permissions

Open source quantified-self infrastructure

Make personal health agents safer, clearer and more useful.