protogrid
Sign inAdd to your agent

Search / io.github.StuMason/polar-flow-server

Polar Health Data (self-hosted)

L0· runs locally

Self-hosted Polar health analytics with a built-in MCP server: sleep, HRV, workouts, baselines.

v1.6.2 · active · repository · website · descriptor JSON · versions

Runs on your machine: something must execute the package.Only local packages are published (npm, PyPI, OCI, …). The registry never executes them, so tools are unknown until you run it.
Quality–not scored
Trust94of 100
Packages1
Tools seen0

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "polar-flow-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATABASE_URL",
        "-e",
        "POLAR_CLIENT_ID",
        "-e",
        "POLAR_CLIENT_SECRET",
        "docker.io/stumason/polar-flow-server:1.6.2"
      ],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}",
        "POLAR_CLIENT_ID": "${POLAR_CLIENT_ID}",
        "POLAR_CLIENT_SECRET": "${POLAR_CLIENT_SECRET}"
      }
    }
  }
}
claude mcp add polar-flow-server -e "DATABASE_URL=${DATABASE_URL}" -e "POLAR_CLIENT_ID=${POLAR_CLIENT_ID}" -e "POLAR_CLIENT_SECRET=${POLAR_CLIENT_SECRET}" -- docker run -i --rm -e DATABASE_URL -e POLAR_CLIENT_ID -e POLAR_CLIENT_SECRET docker.io/stumason/polar-flow-server:1.6.2
[mcp_servers.polar-flow-server]
command = "docker"
args = ["run", "-i", "--rm", "-e", "DATABASE_URL", "-e", "POLAR_CLIENT_ID", "-e", "POLAR_CLIENT_SECRET", "docker.io/stumason/polar-flow-server:1.6.2"]
env = { "DATABASE_URL" = "${DATABASE_URL}", "POLAR_CLIENT_ID" = "${POLAR_CLIENT_ID}", "POLAR_CLIENT_SECRET" = "${POLAR_CLIENT_SECRET}" }

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "polar-flow-server": {
      "type": "local",
      "command": [
        "docker",
        "run",
        "-i",
        "--rm",
        "-e",
        "DATABASE_URL",
        "-e",
        "POLAR_CLIENT_ID",
        "-e",
        "POLAR_CLIENT_SECRET",
        "docker.io/stumason/polar-flow-server:1.6.2"
      ],
      "enabled": true,
      "environment": {
        "DATABASE_URL": "{env:DATABASE_URL}",
        "POLAR_CLIENT_ID": "{env:POLAR_CLIENT_ID}",
        "POLAR_CLIENT_SECRET": "{env:POLAR_CLIENT_SECRET}"
      }
    }
  }
}
{
  "mcpServers": {
    "polar-flow-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATABASE_URL",
        "-e",
        "POLAR_CLIENT_ID",
        "-e",
        "POLAR_CLIENT_SECRET",
        "docker.io/stumason/polar-flow-server:1.6.2"
      ],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}",
        "POLAR_CLIENT_ID": "${POLAR_CLIENT_ID}",
        "POLAR_CLIENT_SECRET": "${POLAR_CLIENT_SECRET}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=polar-flow-server&config=eyJjb21tYW5kIjoiZG9ja2VyIiwiYXJncyI6WyJydW4iLCItaSIsIi0tcm0iLCItZSIsIkRBVEFCQVNFX1VSTCIsIi1lIiwiUE9MQVJfQ0xJRU5UX0lEIiwiLWUiLCJQT0xBUl9DTElFTlRfU0VDUkVUIiwiZG9ja2VyLmlvL3N0dW1hc29uL3BvbGFyLWZsb3ctc2VydmVyOjEuNi4yIl0sImVudiI6eyJEQVRBQkFTRV9VUkwiOiIke0RBVEFCQVNFX1VSTH0iLCJQT0xBUl9DTElFTlRfSUQiOiIke1BPTEFSX0NMSUVOVF9JRH0iLCJQT0xBUl9DTElFTlRfU0VDUkVUIjoiJHtQT0xBUl9DTElFTlRfU0VDUkVUfSJ9fQ%3D%3D"
}
{
  "servers": {
    "polar-flow-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATABASE_URL",
        "-e",
        "POLAR_CLIENT_ID",
        "-e",
        "POLAR_CLIENT_SECRET",
        "docker.io/stumason/polar-flow-server:1.6.2"
      ],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}",
        "POLAR_CLIENT_ID": "${POLAR_CLIENT_ID}",
        "POLAR_CLIENT_SECRET": "${POLAR_CLIENT_SECRET}"
      }
    }
  }
}
{
  "mcpServers": {
    "polar-flow-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATABASE_URL",
        "-e",
        "POLAR_CLIENT_ID",
        "-e",
        "POLAR_CLIENT_SECRET",
        "docker.io/stumason/polar-flow-server:1.6.2"
      ],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}",
        "POLAR_CLIENT_ID": "${POLAR_CLIENT_ID}",
        "POLAR_CLIENT_SECRET": "${POLAR_CLIENT_SECRET}"
      }
    }
  }
}
extensions:
  "polar-flow-server":
    enabled: true
    name: "polar-flow-server"
    type: stdio
    cmd: "docker"
    args:
      - "run"
      - "-i"
      - "--rm"
      - "-e"
      - "DATABASE_URL"
      - "-e"
      - "POLAR_CLIENT_ID"
      - "-e"
      - "POLAR_CLIENT_SECRET"
      - "docker.io/stumason/polar-flow-server:1.6.2"
    envs:
      "DATABASE_URL": "${DATABASE_URL}"
      "POLAR_CLIENT_ID": "${POLAR_CLIENT_ID}"
      "POLAR_CLIENT_SECRET": "${POLAR_CLIENT_SECRET}"
    timeout: 300

Placeholders to fill from your own secret store: ${DATABASE_URL}, ${POLAR_CLIENT_SECRET}. The registry never accepts secret values.

This is a local package: the command runs on your machine.

Quality – / 100not scored

Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.

protocoln/a · weight 25
  • n/a
    protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygienen/a · weight 30
  • n/a
    tools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)
stabilityn/a · weight 15
  • n/a
    stability.changes, stability.rug_pulltool list unknown
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

Tool list unknown · checked 2026-10-19 21:10 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 94 / 100

provenance90
livenessn/a
freshness100
hygiene95

+repository +namespace-matches-repo +website ~liveness-unmeasured +updated-0d-ago -unpinned-packages(1)

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

packageregistryversionruntimesecrets
docker.io/stumason/polar-flow-server:1.6.2ociunpinned–DATABASE_URL, POLAR_CLIENT_SECRET

Tools (0)

No tools observed. Local packages are never executed by the registry.

Schemas: list_tools.

Similar MCP servers

  • polarmcpL0
    io.github.davidmosiah/polarmcp

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

  • samsung-health-mcpL0
    io.github.davidmosiah/samsung-health-mcp

    Unofficial local-first MCP server for Samsung Health personal-data CSV/ZIP exports.

  • Futureweb Intervals MCPL0
    io.github.futureweb/intervals-mcp-server

    Self-hosted Intervals.icu MCP server: training analytics, Garmin data, wellness, workout planning

  • Health Hub MCPunknown
    io.github.naymEvg/health-mcp

    Self-hosted MCP server for Android Health Connect — 34 metrics, daily rollups, dedup, 5 LLM tools.

  • Apple HealthL0
    io.github.neiltron/apple-health-mcp

    Local-first Apple Health MCP server for questions about your sleep, workouts and heart data.

  • apple-health-mcpL0
    io.github.davidmosiah/apple-health-mcp

    Unofficial local-first MCP server for Apple Health export data.

More from io.github.StuMason

  • coolifyL0
    io.github.StuMason/coolify

    46 optimized tools for managing Coolify infrastructure, diagnostics, and docs search

Official server.json
{
  "name": "io.github.StuMason/polar-flow-server",
  "title": "Polar Health Data (self-hosted)",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "version": "1.6.2",
  "packages": [
    {
      "transport": {
        "url": "http://localhost:8000/mcp",
        "type": "streamable-http"
      },
      "identifier": "docker.io/stumason/polar-flow-server:1.6.2",
      "registryType": "oci",
      "environmentVariables": [
        {
          "name": "DATABASE_URL",
          "format": "string",
          "isSecret": true,
          "isRequired": true,
          "description": "PostgreSQL connection string, e.g. postgresql+asyncpg://user:pass@host:5432/polar"
        },
        {
          "name": "POLAR_CLIENT_ID",
          "format": "string",
          "isRequired": true,
          "description": "Polar AccessLink OAuth client id (register at admin.polaraccesslink.com)"
        },
        {
          "name": "POLAR_CLIENT_SECRET",
          "format": "string",
          "isSecret": true,
          "isRequired": true,
          "description": "Polar AccessLink OAuth client secret"
        },
        {
          "name": "BASE_URL",
          "format": "string",
          "description": "Public HTTPS base URL of this deployment; enables OAuth sign-in for MCP connectors"
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/StuMason/polar-flow-server",
    "source": "github"
  },
  "websiteUrl": "https://stumason.github.io/polar-flow-server/",
  "description": "Self-hosted Polar health analytics with a built-in MCP server: sleep, HRV, workouts, baselines."
}