Polarmcp MCP Server

Privacy-first MCP server for Polar AccessLink — health, sleep and training data.

Local serverstdio

What is the Polarmcp MCP server?

Most developer tooling work still happens through a UI a human drives. Polarmcp MCP server moves it into the conversation instead. Privacy-first MCP server for Polar AccessLink — health, sleep and training data.

The short version

Getting it running

Installation goes through your MCP client rather than a global install: point it at delx-wellness-hermes on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

The tools it exposes

The server publishes 5 tools. What each one is for:

  • 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_daily_summary — sleep, activity, Nightly Recharge and training brief for today
  • polar_weekly_summary — scorecard, comparison vs prior week, next-week plan
  • polar_get_route — GPS coordinates redacted unless raw mode

What it needs from you

Configuration is passed through the environment: POLAR_CLIENT_ID, POLAR_CLIENT_SECRET, POLAR_TOKEN_PATH, POLAR_CACHE_PATH. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

How it compares

Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Polarmcp's toolset — polar_connection_status, polar_data_inventory, polar_daily_summary and 2 more — is a fair guide to whether it matches your workflow. It is maintained by davidmosiah; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Polarmcp's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Available tools

ToolWhat it does
polar_connection_statusverify local setup, scopes and readiness before calling Polar
polar_data_inventoryinventory supported data domains, scopes, privacy modes and recommended first calls without calling Polar APIs.
polar_daily_summarysleep, activity, Nightly Recharge and training brief for today
polar_weekly_summaryscorecard, comparison vs prior week, next-week plan
polar_get_routeGPS coordinates redacted unless raw mode

How to install the Polarmcp MCP server

{
  "mcpServers": {
    "polarmcp": {
      "command": "npx",
      "args": ["-y", "delx-wellness-hermes"],
      "env": {
        "POLAR_CLIENT_ID": "your-value",
        "POLAR_CLIENT_SECRET": "your-value",
        "POLAR_TOKEN_PATH": "your-value",
        "POLAR_CACHE_PATH": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
POLAR_CLIENT_IDConfiguration value read at startup.Optional
POLAR_CLIENT_SECRETCredential the server authenticates with.Yes
POLAR_TOKEN_PATHCredential the server authenticates with.Yes
POLAR_CACHE_PATHFilesystem location the server is allowed to use.Optional

Example prompts to try

  • Use Polarmcp to polar connection status.
  • Use Polarmcp to polar data inventory.
  • Use Polarmcp to polar daily summary.

Frequently asked questions

It connects Polarmcp to MCP-compatible AI assistants such as Claude and Cursor, exposing 5 tools (polar_connection_status, polar_data_inventory, polar_daily_summary, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Polarmcp directly.