Polar MCP Unofficial MCP Server

by davidmosiahio.github.davidmosiah/polarmcpv0.3.6

Privacy-first unofficial Polar AccessLink v4 MCP server for AI health, sleep and training agents.

6Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active2d ago

Install Polar MCP Unofficial MCP server

claude mcp add polar-mcp-unofficial -e POLAR_CLIENT_SECRET='<polar-client-secret>' -- npx -y polar-mcp-unofficial

{
  "mcpServers": {
    "polar-mcp-unofficial": {
      "command": "npx",
      "args": [
        "-y",
        "polar-mcp-unofficial"
      ],
      "env": {
        "POLAR_CLIENT_SECRET": "<polar-client-secret>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "polar-mcp-unofficial": {
      "command": "npx",
      "args": [
        "-y",
        "polar-mcp-unofficial"
      ],
      "env": {
        "POLAR_CLIENT_SECRET": "<polar-client-secret>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "polar-mcp-unofficial": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "polar-mcp-unofficial"
      ],
      "env": {
        "POLAR_CLIENT_SECRET": "<polar-client-secret>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "polar-mcp-unofficial": {
      "command": "npx",
      "args": [
        "-y",
        "polar-mcp-unofficial"
      ],
      "env": {
        "POLAR_CLIENT_SECRET": "<polar-client-secret>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
POLAR_CLIENT_ID	—	—	Polar OAuth client ID. Optional when configured with polar-mcp-server setup.
POLAR_CLIENT_SECRET	—	yes	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.

Freshness

Active — last maintenance signal 2d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-08 · 2d ago · GitHub
Latest release
2026-10-03 · 7d ago · GitHub · v0.5.4
Package published
no data · npm/PyPI
Registry entry updated
2026-07-13 · 3mo ago · official registry · v0.3.6

FAQ

›How do I install the Polar MCP Unofficial MCP server in Claude Code?

Run: claude mcp add polar-mcp-unofficial -e POLAR_CLIENT_SECRET='<polar-client-secret>' -- npx -y polar-mcp-unofficial. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Polar MCP Unofficial require an API key?

Yes. It expects POLAR_CLIENT_SECRET, of which 1 is a secret.

›Can I use Polar MCP Unofficial as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Polar MCP Unofficial in the official MCP registry?

Yes, as io.github.davidmosiah/polarmcp.