polarmcp

ローカル

wellness.delx.aiヘルスケア63 週間前に更新

polarmcp について

Polar を使うトレーニング・健康エージェント向けのローカルサーバーで、AccessLink v4 の睡眠、回復、トレーニング、生理データを取得できます。OAuth をローカルで処理し、エンドポイントの応答を整え、GPS 座標とトークンを既定で秘匿します。

主な機能

01睡眠、Nightly Recharge、活動データの取得
02トレーニング負荷、目標、テスト情報の取得
03連続心拍、PPI、温度サンプルへのアクセス
04日次・週次トレーニングサマリーの提供
05GPS 座標の秘匿とトークンのローカル保存
06プロンプト、リソース、プライバシー監査ツール

活用シーン

01睡眠、活動、回復、トレーニングの日次要約
02週ごとのトレーニング負荷と回復傾向の比較
03心拍数と PPI サンプルによる生理データの確認

MCP 対応

Polar AccessLink Dynamic API v4 のデータを、MCP ツール、プロンプト、リソースとして公開します。既定の STDIO に加えてループバック限定のステートレス Streamable HTTP に対応し、OAuth トークンはローカルに保存します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "davidmosiah-polarmcp": {
      "command": "npx",
      "args": [
        "-y",
        "polar-mcp-unofficial"
      ],
      "env": {
        "POLAR_CLIENT_ID": "<POLAR_CLIENT_ID>",
        "POLAR_CLIENT_SECRET": "<POLAR_CLIENT_SECRET>",
        "POLAR_REDIRECT_URI": "<POLAR_REDIRECT_URI>",
        "POLAR_TOKEN_PATH": "<POLAR_TOKEN_PATH>",
        "POLAR_PRIVACY_MODE": "<POLAR_PRIVACY_MODE>",
        "POLAR_CACHE": "<POLAR_CACHE>",
        "POLAR_CACHE_PATH": "<POLAR_CACHE_PATH>",
        "POLAR_NO_CACHE": "<POLAR_NO_CACHE>"
      }
    }
  }
}

起動コマンドnpx -y polar-mcp-unofficial

設定が必要な環境変数

POLAR_CLIENT_IDPolar OAuth client ID. Optional when configured with polar-mcp-server setup.

POLAR_CLIENT_SECRETシークレット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_URIRedirect 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_MODEOptional payload mode: summary, structured, or raw. Defaults to structured. raw means full Polar AccessLink payloads for supported endpoints.

POLAR_CACHEOptional SQLite cache toggle. Set to true or sqlite to enable.

POLAR_CACHE_PATHOptional local SQLite cache path. Defaults to ~/.polar-mcp/cache.sqlite.

POLAR_NO_CACHESet 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.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npmpolar-mcp-unofficial0.3.6stdio

ツール

掲載時のツール一覧 · 2 週間前に更新

パラメーター	型	必須	説明
response_format	enum	いいえ	markdown \| json

詳細

Polar MCP

Polar Nightly Recharge、トレーニング負荷、PPI、HRV のデータを AI エージェントに提供します — ローカルで。
ローカルファーストの MCP サーバー — トークンがマシンの外に出ることはありません。

⚡ Delx Wellness for Hermesによるワンコマンドインストール： npx -y delx-wellness-hermes setup — このコネクターとほかの8つを、専用のHermesプロファイルに事前設定します。

または、Claude Desktop／Cursor／ChatGPT Desktopに単独で接続できます — 詳しくは以下のインストールセクションをご覧ください。

HTTP（v2 ステートレス）

デフォルトはstdioです。オプションでStreamable HTTPを利用できます — セッションIDなし、JSONレスポンス、ループバックのみ：

npx -y polar-mcp-unofficial --http
# GET  http://127.0.0.1:3000/health
# POST http://127.0.0.1:3000/mcp   (sessionless)

環境変数：POLAR_MCP_HOST、POLAR_MCP_PORT、POLAR_MCP_TRANSPORT=http。

AI エージェントをPolarのトレーニング、睡眠、Nightly Recharge、連続サンプルデータに接続する、ローカルファーストのMCP サーバーです。

非公式プロジェクトです。 Polar Electro Oyとは提携しておらず、同社による承認やサポートも受けていません。Polarはそれぞれの所有者の商標です。ご自身のPolarアカウントでのみ、Polar AccessLink APIの利用規約に従ってご使用ください。

Claude、Cursor、Hermes、OpenClawなどのMCP対応エージェントを使い、Polar Flowから数値をコピー＆ペーストせずに、トレーニング負荷、回復、持久力について考えたい人のために、David Mosiahが開発しました。

ローカルファーストのウェルネスMCPコネクターを集めたレジストリ、Delx Wellnessの一部です。

このコネクターがエージェントのワークフローに役立つ場合は、リポジトリにスターを付けてください。スターが増えると、ほかのAI開発者にプロジェクトを見つけてもらいやすくなり、Delxがローカルファーストのウェルネス基盤を提供し続ける助けになります。

これが存在する理由

Polar は、一般消費者向けウェアラブルの中でも特に充実したトレーニング生理学機能を備えています。Nightly Recharge、連続サンプル、PPI（脈拍間隔）、トレーニング目標、スポーツプロフィール、起立試験、フィットネステストなどです。Polar AccessLink Dynamic API v4 はこれらのデータを公開していますが、細分化された16個のOAuthスコープがあり、一般的な消費者向けAPIより構造を把握しにくくなっています。

このパッケージは、OAuthの手続きをローカルで処理し、v4エンドポイント間でレスポンスを正規化し、デフォルトでGPSデータを秘匿して、Model Context Protocolを通じてPolarを公開します。トークンがデバイスの外に出ることはありません。

60秒でセットアップ

Polar AccessLinkクライアント（こちらで作成できます）と、リダイレクトURI http://127.0.0.1:3000/callback が必要です。

npx -y polar-mcp-unofficial setup    # interactive: paste client id + secret
npx -y polar-mcp-unofficial auth     # opens browser, captures the OAuth code
npx -y polar-mcp-unofficial doctor   # verifies you're ready

推奨スコープ（必要なデータに合わせて選択してください）：

activity:read calendar:read continuous_samples:read devices:read
nightly_recharge:read ppi_data:read profile:read routes:read
skin_contact:read sleep:read sports:read temperature_measurement:read
tests:read training_sessions:read training_targets:read user_subscription:read

次に、これをMCPクライアントの設定に追加します。

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

Claude Desktopの場合は、setup --client claude を実行すると、スニペットが自動的に書き込まれます。

エージェントで試す

まずは、次の3つを尋ねてみてください。

Use polar_connection_status to check setup, then run polar_daily_summary.
Give me a 5-line training brief for today.

Call polar_weekly_summary with response_format=json. Identify my biggest
training-load/recovery bottleneck and give me a next-week plan.

Use the polar_training_load_investigation prompt, after=2026-04-01.
Walk me through my recent training sessions + Nightly Recharge.

データの利用可否

このパッケージは、公式のPolar AccessLink Dynamic API v4を使用します。このREADMEで raw と記載している場合、対応エンドポイントの上流にあるPolar JSONを指します。デバイスの生センサーストリームを指すものではありません。

データ	利用可否	備考
日次アクティビティ＋カレンダー	はい	`activity:read` / `calendar:read` が必要です
睡眠＋睡眠・覚醒ベクトル	はい	`sleep:read` が必要です
Nightly Recharge（回復スコア）	はい	`nightly_recharge:read` が必要です。対応デバイスのみ
トレーニングセッション＋トレーニング目標	はい	`training_sessions:read` / `training_targets:read` が必要です
連続サンプル（時間経過に伴う心拍数）	はい	`continuous_samples:read` が必要です
PPIサンプル（脈拍間隔、HRV関連）	はい	`ppi_data:read` が必要です。対応デバイスのみ
体温測定	はい	`temperature_measurement:read` が必要です。対応デバイスのみ
皮膚接触期間	はい	`skin_contact:read` が必要です
テスト（フィットネス／起立／ランニング）	はい	`tests:read` が必要です
ルート＋GPSデータ	オプトイン	rawモードでない限り、GPS座標は秘匿されます
スポーツ＋スポーツプロフィール＋デバイス	はい	カタログとユーザーメタデータ
デバイスのライブテレメトリー	-	Polar AccessLinkでは公開されていません

ツール

まずはこちらから：

polar_quickstart - すでに設定されている内容に応じて調整される、パーソナライズされた3ステップのセットアップガイド
polar_connection_status - Polar を呼び出す前に、ローカルのセットアップ、スコープ、準備状況を確認します
polar_data_inventory — Polar API を呼び出さずに、サポートされているデータドメイン、スコープ、プライバシーモード、おすすめの最初の呼び出しを一覧表示します。
polar_demo - エージェントが実際の API を呼び出す前に仕様を確認できる、合成データのサンプルペイロード
polar_daily_summary - 今日の睡眠、アクティビティ、Nightly Recharge、トレーニングの概要
polar_weekly_summary - スコアカード、前週との比較、来週の計画
polar_wellness_context - 共有の wellness_context 形式による Nightly Recharge、睡眠、トレーニング負荷

認証と診断

polar_capabilities、polar_agent_manifest、polar_privacy_audit、polar_cache_status
polar_get_auth_url、polar_exchange_code、polar_revoke_access

アカウント

polar_get_account_data、polar_list_user_devices、polar_list_subscriptions

共有ウェルネスプロフィール（ローカルのみ、Polar のデータは含みません）

polar_onboarding、polar_profile_get、polar_profile_update — 他のコネクターと共有する Delx Wellness プロフィールです。保存するのはユーザーが入力した情報のみで、トークンやバイオマーカーは保存しません

アクティビティと睡眠

polar_list_activity、polar_list_calendar
polar_list_sleeps、polar_list_sleep_wake_vectors — 睡眠一覧では、デフォルトで利用可能な日付に対して v4 の sleep-result、sleep-evaluation、sleep-score 機能のデータを取得します
polar_list_nightly_recharge

心拍と生理データ（日付範囲）

polar_heart_series — 連続サンプルから取得する agent-safe-series/v1 形式の範囲制限付き心拍数です（エージェントにはこちらを推奨します）
polar_list_continuous_samples、polar_list_ppi_samples
polar_list_temperature_measurements、polar_list_skin_contacts

トレーニング

polar_list_training_sessions、polar_list_training_targets、polar_list_training_target_favorites
polar_list_tests

スポーツとルート

polar_list_sports、polar_list_sport_profile_catalog、polar_list_sport_profiles
polar_get_route - raw モード以外では GPS 座標が秘匿されます

プロンプト

polar_daily_checkin - 毎日のトレーニングと回復状況を確認するための実践的なチェックイン
polar_weekly_review - アクティビティ、睡眠、回復の傾向を振り返ります
polar_training_load_investigation - トレーニングセッションと回復状況を調査します

リソース

polar://capabilities、polar://agent-manifest、polar://inventory
polar://summary/daily、polar://summary/weekly
polar://account-data、polar://latest/sleep

プライバシーとセキュリティ

OAuth トークンは ~/.polar-mcp/tokens.json に 0600 の権限で保存され、ツールから返されることはありません。
サーバーがアクセストークンやリフレッシュトークンを出力することはありません。
POLAR_PRIVACY_MODE のデフォルトは structured です。structured モードでは、上流から取得した生理データのペイロード全体を保持しながら、シークレット/GPS フィールドを取り除きます。正規化された別名は追加されますが、ネストされた v4 オブジェクトに置き換わることはありません。Polar の生 JSON は、raw モードまたは呼び出しごとのオーバーライドでのみ取得できます。
GPS ルートの形状データは summary および structured モードでは秘匿され、raw 座標が公開されるのは raw モードのみです。
日付形式とサポートされる features はエンドポイントごとに検証されます。Polar が1日に制限している機能クエリでは、利用可能な日付を1日ずつ取得します。
MCP クライアントがアクセストークンやリフレッシュトークンを参照することはありません。
これは医療上のアドバイスではありません。サーバーが公開するのは、個人の AI ワークフロー向けにユーザーが許可したデータであり、診断やトレーニング処方を目的とするものではありません。

設定

setup は、これらの設定の大部分を ~/.polar-mcp/config.json に 0600 の権限で書き込みます。手動での env オーバーライドもサポートされています。

POLAR_CLIENT_ID=<client-id>
POLAR_CLIENT_SECRET=<client-secret>
POLAR_REDIRECT_URI=http://127.0.0.1:3000/callback

# Optional
POLAR_SCOPES="activity:read calendar:read continuous_samples:read ..."
POLAR_PRIVACY_MODE=structured        # summary | structured | raw
POLAR_CACHE=sqlite                   # optional read-through cache
POLAR_TOKEN_PATH=~/.polar-mcp/tokens.json
POLAR_CACHE_PATH=~/.polar-mcp/cache.sqlite

Hermes / リモート設定

npx -y polar-mcp-unofficial setup --client hermes --no-auth
npx -y polar-mcp-unofficial auth                      # run locally if browser auth is needed
npx -y polar-mcp-unofficial doctor --client hermes
hermes mcp test polar

Hermes の設定を変更した後は、/reload-mcp または hermes mcp test polar を使用してください。通常のデータアクセスではゲートウェイを再起動する必要はありません。

ブラウザー OAuth を Hermes とは別のマシンで行う必要がある場合は、ローカルで auth を実行し、~/.polar-mcp/tokens.json を chmod 600 を指定してサーバーにコピーしてください。

要件

Node.js 20+
リダイレクト URI が http://127.0.0.1:3000/callback の Polar AccessLink クライアント（https://admin.polaraccesslink.com）

開発

git clone https://github.com/davidmosiah/polar-mcp.git
cd polar-mcp
npm install
npm test
npm run build

MCP Inspector でテストします：

npx @modelcontextprotocol/inspector node dist/index.js

リンク

npm：https://www.npmjs.com/package/polar-mcp-unofficial
ドキュメントサイト：https://wellness.delx.ai/connectors/polar
旧ドキュメント：https://polarmcp.vercel.app/
GitHub：https://github.com/davidmosiah/polar-mcp
Delx Wellness レジストリ：https://github.com/davidmosiah/delx-wellness
コネクターの品質基準：https://github.com/davidmosiah/delx-wellness/blob/main/docs/connector-quality-standard.md
Polar AccessLink Dynamic API v4 ドキュメント：https://www.polar.com/polar-api-v4/

📧 お問い合わせとサポート

📨 [email protected] — 一般的な質問、統合のサポート、パートナーシップ
🐛 バグ報告／機能リクエスト — GitHub Issues
🐦 最新情報 — X の @delx369
🌐 サイト — wellness.delx.ai

ライセンス

MIT — LICENSE を参照してください。

免責事項

本ソフトウェアは現状有姿で提供されます。医療機器ではなく、医療上の助言を提供するものでもありません。また、診断、治療、トレーニング内容の処方に使用しないでください。医療やトレーニングに関する懸念がある場合は、必ず資格を持つ専門家に相談してください。

スキルまたは MCP

同じパッケージを、2つの方法で利用できます。MCP は stdio／HTTP でツールを登録します。スキルは、クライアントが MCP に対応していない場合に、CLI を通じて同じツールを操作できます：

npx -y polar-mcp-unofficial call polar_connection_status --json '{}'

skill/SKILL.md をエージェントのスキルディレクトリにコピーしてください。

Markdown 対応

ログインしてコメント

基本情報

作者: davidmosiah
言語: node
バージョン: 0.3.6
トランスポート: stdio
掲載日: 2026年7月13日
最終更新: 3 週間前
公式 Registry: io.github.davidmosiah/polarmcp

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

プロバイダー	パッケージ	リポジトリ
WHOOP	`whoop-mcp-unofficial`	whoop-mcp
Oura	`oura-mcp-unofficial`	ouramcp
Garmin	`garmin-mcp-unofficial`	garminmcp
Strava	`strava-mcp-unofficial`	strava-mcp
Fitbit	`fitbit-mcp-unofficial`	fitbitmcp
Withings	`withings-mcp-unofficial`	withingsmcp
Apple Health	`apple-health-mcp-unofficial`	apple-health-mcp
Polar	`polar-mcp-unofficial`	polar-mcp
Nourish（栄養）	`wellness-nourish`	wellness-nourish