Polarmcp

Give your AI agent your Polar Nightly Recharge, training load, PPI and HRV data locally. Its 9 documented tools cover polar, summary.

People who work with polar and summary and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-03 · ★ 6 · #35 OF 71 MAINTAINED SCIENCE & HEALTH · VERIFIED 2026-09-18

MIT · TypeScript servers · how we verify → /methodology

01 · Install Polarmcp

before you install - you'll need

Set POLAR_CLIENT_ID, POLAR_CLIENT_SECRET, POLAR_REDIRECT_URI, POLAR_SCOPES, POLAR_TOKEN_PATH, POLAR_CACHE_PATH before connecting. POLAR_PRIVACY_MODE, POLAR_CACHE are optional or environment-specific per the README.

Claude Code

claude mcp add davidmosiah-polar-mcp -- npx -y polar-mcp-unofficial

Claude Desktop / Cursor / VS Code - add to config

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

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package polar-mcp-unofficial - unscoped; check the name against the project README before installing

registry namespace io.github.davidmosiah is GitHub-verified and matches the repo owner

03 · What Polarmcp can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

An agent gets 9 documented tools spanning polar, summary, including polar_quickstart, polar_connection_status, polar_data_inventory, polar_demo.

The 9 tools it gives your agent

Extracted from the project's README - what polarmcp lets an agent do.

polar_quickstart
- personalized 3-step setup walkthrough that adapts to what's already configured
polar_connection_status
- verify local setup, scopes and readiness before calling Polar
polar_data_inventory
- inventory supported data domains, scopes, privacy modes and recommended first calls without calling Polar APIs.
polar_demo
- synthetic example payloads so agents see the contract before calling the real API
polar_daily_summary
- sleep, activity, Nightly Recharge and training brief for today
polar_weekly_summary
- scorecard, comparison vs prior week, next-week plan
polar_wellness_context
- Nightly Recharge, sleep and training load in the shared wellness_context shape
polar_heart_series
- agent-safe-series/v1 bounded HR from continuous samples (prefer this for agents)
polar_get_route
- GPS coordinates redacted unless raw mode

Latest releases

v0.5.3 · 2026-08-29

Skill layer next to MCP. Same binary: MCP tools or call <tool> --json. Mutation gates identical.

v0.3.14 · 2026-07-30

exchange_code intent wording, scorecard 100 + CI scorecard gate. npm:

v0.1.2 · 2026-05-05

Initial Polar MCP release · 30 MCP tools + 6 resources + 3 prompts for Polar AccessLink Dynamic API v4. Local-first OAuth with tokens stored in ~/.polar-mcp/. · Coverage · Account, devices, activity, calendar, sleep…

04 · Who maintains Polarmcp

polarmcp is maintained by davidmosiah. We track 30 MCP servers from davidmosiah - 30 actively maintained, 144 combined GitHub stars, oldest repo from Apr 2026. Full record: all servers from davidmosiah.

  1. google-health-mcp Privacy-first unofficial Google Health API v4 MCP server for health, sleep, activity, HR agents ★ 57
  2. garminmcp Privacy-first unofficial Garmin Connect MCP for AI health, sleep, activity & recovery agents. ★ 12
  3. whoop-mcp Privacy-first, unofficial WHOOP MCP server for AI health, sleep, recovery, and performance agents. ★ 13
  4. wellness-nourish Local-first nutrition MCP for AI agents: food, barcode, photo, intake, hydration, goals. ★ 9
  5. ouramcp Privacy-first, unofficial Oura MCP server for AI health, sleep, activity and heart-rate agents. ★ 4
  6. samsung-health-mcp Unofficial local-first MCP server for Samsung Health personal-data CSV/ZIP exports. ★ 14

05 · Facts

category
science & health - ranked #35 of 71 actively-maintained science & health servers as of 2026-09-18.
release cadence
2 releases in the last 90 days (latest 2026-08-29)
registry
io.github.davidmosiah/polarmcp (active, first published 2026-05-05 · 3 versions)
packages
npm:polar-mcp-unofficial

06 · Polarmcp FAQ

Is Polarmcp still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-03 and it shipped 2 releases in the last 90 days. We re-verify nightly.

What can Polarmcp do?

An agent gets 9 documented tools spanning polar, summary, including polar_quickstart, polar_connection_status, polar_data_inventory, polar_demo.

How do I install Polarmcp?

Run `npx -y polar-mcp-unofficial`. The README documents 8 environment variables (POLAR_CLIENT_ID, POLAR_CLIENT_SECRET, POLAR_REDIRECT_URI…) to set first. Set POLAR_CLIENT_ID, POLAR_CLIENT_SECRET, POLAR_REDIRECT_URI, POLAR_SCOPES, POLAR_TOKEN_PATH, POLAR_CACHE_PATH before connecting. POLAR_PRIVACY_MODE, POLAR_CACHE are optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Polarmcp run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Polarmcp