AppleヘルスケアをCursorにMCPで連携する

CursorのMCP設定に必要なもの

ヘルスケアの記録があるiPhone、App Storeのteloアプリ、Cursor（エディタかCLI）。teloでサインインして、履歴を送信してください。何かを読めるようになるのは、最初の同期が終わってからです。

手順は、上の日付に確認したCursorのドキュメントに沿ったもので、すべてのバージョンでteloとの動作を確認したわけではありません。

mcp.jsonにAppleヘルスケアのMCPサーバーを追加する

すべてのプロジェクトで使うなら~/.cursor/mcp.jsonに、1つのプロジェクトだけなら、その中の.cursor/mcp.jsonに追加します。すでにあるサーバーとまとめてください。ヘッダーもAPIキーも要りません。teloはOAuthを使います。

フォルダが共有のリポジトリなら、グローバルのファイルを使いましょう。どの健康サービスを使っているかが、コミットからチームに伝わらずにすみます。

{
  "mcpServers": {
    "telo": {
      "url": "https://telo.health/mcp"
    }
  }
}

OAuthでサインインする

エディタでは、サイドバーのCustomizeを開き、MCPサーバーの中からteloを探してサインインします。ブラウザでteloのページが開きます。メールアドレスを入力し、6桁のコードを入力して、アクセスを承認します。コードやトークンをチャットに貼り付けないでください。

CLIでは、コマンド名はagentです。agent mcp login teloを実行します。

CursorがAppleヘルスケアを読めるか確かめる

1. エディタでは、Available Toolsの下にteloのツールが表示されるはずです。CLIでは、agent mcp list-tools teloを実行します。
2. エージェントに、teloを使って、利用できる指標とその期間を一覧にするよう頼みます。
3. 回答が、実際の日付を返すteloのツール呼び出しから来ているか確認します。ツールを呼び出さずにデータを説明しているなら、それは推測です。
4. 何も接続できない場合は、Outputパネル（Cmd+Shift+U）を開き、MCP Logsを選びます。

最初のプロンプト

最初にカバー範囲を聞くと、欠けている部分が見えたままになります。記録のない日は「使えない」日であって、ゼロではありません。

teloを使って、どのAppleヘルスケアの指標が使えて、どれくらい新しいかを確認してください。そのうえで、直近7日間の睡眠と安静時心拍数をその前の7日間と比べ、記録のない日付を挙げてください。

トラブルシューティングと削除

Cloud Agentsは独自にサインインします。デスクトップでteloを接続してもCloud Agentはサインインされず、その逆も同じです。

teloの使用をやめるには、Customizeでオフにするか削除します。CLIでは、agent mcp disable teloを実行するか、mcp.jsonからエントリを消します。接続はできているのに記録がない場合は、teloアプリで同期を確認してください。MCPの接続が動いていても、iPhoneでHealthKitの読み取り権限が許可されたとは限りません。

よくある質問