個人向けAPI・外部連携
自分のKaloriを、外部からも。
ChatGPT・ClaudeからはMCPコネクタで、自作ツールからは一時トークンのREST APIで。自分の食事記録やカタログ検索を外部から使えます。
これは個人のKaloriアカウント向け機能です。アプリの月額プランに含まれ、API単体の追加料金はありません。
ベースURL: https://app.kalori.jp/api/v1/ext
チャットAIとつなぐ(MCP) おすすめ
Claude や ChatGPT のコネクタに URL をひとつ登録するだけ。Apple でサインインすれば接続完了で、トークンのコピーや再発行は不要です(接続は自動で維持されます)。検索・記録・修正・運動・体重・お気に入り・味評価・予算・セット提案まで、アプリの主要機能がチャットから使えます。
接続URL: https://mcp.kalori.jp/mcp
対応アプリ: Claude(無料プランOK)・ChatGPT(無料プランOK・Developer mode)・Perplexity など MCP 対応のチャットAI。
Kaloriアカウントの連携が必要です。カタログ検索は購入なしで利用できます。 個人の記録機能は、連携したアカウントの利用権(Premium)または外部連携のお試しで利用できます。お試しは初回の対象操作から連続7日間です。
設定手順とできることの詳細(MCP ガイド)REST API(個人アカウント向け)
MCP を使わない環境 — curl・自作スクリプト・独自エージェントなど — から直接呼ぶための REST API です。カタログ検索、食事記録、残り PFC に合うセット提案まで、MCP と同じ機能を同じ枠で使えます。Free はお試し枠、本格利用はアプリの月額プランに含まれます。
手動トークンでの使い方(curl など上級者向け)
- 1.
アプリでトークンを発行
kalori アプリ →「マイページ」→「外部AI連携」から一時トークンを発行します。Free はお試し用に15分・1本、アプリの月額プランなら1〜24時間・最大5本まで選べます。
- 2.
AI に許可ドメインを追加
Claude や ChatGPT の設定で、追加の許可ドメインに *.kalori.jp を一度だけ登録します。
- 3.
トークンを貼り付けて呼び出す
発行された ext_ で始まるトークンを Authorization ヘッダに添えてリクエストします。全仕様は GET /help がそのまま返すので、AI に読ませるだけで使い方を理解します。
できること
取得
-
GET /me— 自分のプラン・目標・利用状況(全プラン) -
GET /search— 統合カタログ検索(商品 + 料理名。名前・カロリー・店舗で絞り込み・全プラン) -
GET /shops— 掲載チェーン店一覧(全プラン) -
GET /meals— 食事記録(日付・範囲で取得・月額プラン) -
GET /nutrition— 日別の目標・摂取・残量(月額プラン) -
GET /exercises— 運動記録(月額プラン) -
GET /weights・POST /weights— 体重の取得と記録(月額プラン)
記録・提案(アプリ月額プラン)
-
POST /meals— 食事を記録(最大10件まとめて。内訳・料理名マスタ対応) -
PUT /meals/:id— 記録を修正(量・内訳・スロット) -
DELETE /meals/:id— 食事を削除 -
POST /sets— 残りのPFCに合うセットを提案
呼び出し例
ext_ トークンを Bearer に添えるだけ。レスポンスは AI が読みやすいフラットな JSON です。
curl -H "Authorization: Bearer ext_xxx" \
https://app.kalori.jp/api/v1/ext/me
curl -H "Authorization: Bearer ext_xxx" \
"https://app.kalori.jp/api/v1/ext/products?q=サラダチキン&calMax=200" Free とアプリ月額プラン
Kaloriアカウントの連携が必要です。カタログ検索は購入なしで利用できます。 個人の記録機能は、連携したアカウントの利用権(Premium)または外部連携のお試しで利用できます。お試しは初回の対象操作から連続7日間です。
| Free(お試し) | アプリ月額プラン | |
|---|---|---|
| 呼び出し回数 | 10回 / 日 | 100回 / 時 |
| トークン有効期限 | 15分 | 1〜24時間で選択 |
| 同時トークン | 1本 | 5本 |
| カタログ検索(商品・料理名・店舗) | ✓ | ✓ |
| 自分の記録の読み書き(食事・栄養・運動・体重・お気に入り・味評価) | — | ✓ |
| 範囲取得(食事 / 栄養) | — | 14日 / 90日 |
| セット提案 | — | ✓ |
Kaloriアカウントの連携が必要です。カタログ検索は購入なしで利用できます。 個人の記録機能は、連携したアカウントの利用権(Premium)または外部連携のお試しで利用できます。お試しは初回の対象操作から連続7日間です。
トークンはあなた専用です。第三者と共有しないでください。アプリからいつでも失効できます。
法人向けカタログAPIをお探しの方へ (法人向け)
商品・栄養カタログをアプリやサービスへ組み込む法人利用は、Kalori Catalog APIとしてご案内しています。
Kalori Catalog APIを見る