Mottainai Docs

日本語

English
Deutsch

日本語

English
Deutsch

Appearance

Als Markdown

在庫と買い物リスト ​

TIP

在庫機能をどのように活用できるかアイデアをお探しですか？ 家庭と食品の管理ガイド をご覧ください。

在庫管理は、自宅にあるものをすべて把握するための機能です。冷蔵庫の食材、食品棚のストック、 冷凍庫の中身など、管理したいものを何でも記録できます。残り少なくなっているものを確認したり、 賞味期限が近いものを見逃さずに済んだり、買い物リストを使って帰宅後に在庫を自動更新したり することができます。

管理できるもの ​

在庫の各アイテムには、次の情報を記録できます。

  • 名前 — 例：「オリーブオイル」「オーツミルク 1L」
  • 数量 — どれだけあるか。半分など小数での記録も可能
  • 単位 — g、kg、ml、L、小さじ、大さじ、カップ、oz、lb、個、ひとつまみ、束
  • パッケージサイズ — 同じ商品を複数本管理するときに便利
  • 保管場所 — 冷蔵庫、冷凍庫、食品棚など、好きな名前で設定可能
  • カテゴリ — 乳製品、野菜・果物、パン類など
  • 賞味期限 — 棚の奥で忘れられないように
  • 購入日とバーコード — より詳細に記録したい場合に
  • メモ — 補足情報や、関連アイテムへのリンク

アイテムは保管場所ごとにグループ化されるので、冷蔵庫・食品棚・冷凍庫をすっきり分けて 見ることができます。

はじめに： ダッシュボードからストレージを作成し、必要に応じてメンバーを招待してください。

アイテムの追加 ​

+ ボタンをタップしてアイテムを追加できます。追加方法は3種類あります。

  • 手入力 — 名前、数量、賞味期限などを直接入力する
  • 自由記述 — 「牛乳2本、3月20日まで」のように書くだけで、AIが詳細を自動抽出する
  • レシートを撮影 — 写真を撮るか画像をアップロードすると、Mottainaiがアイテムを 自動で読み取る

「オーツミルク 1L」のように名前を入力すると、単位とパッケージサイズを自動で認識します。 別々に入力する必要はありません。

在庫の管理 ​

アイテムを編集する — アイテムをタップまたはクリックして開き、変更したいフィールドを 編集して保存します。

アーカイブ — 使い切ったアイテムは数量を0にしてください。アイテムはアーカイブ表示に 移り、グレーアウトされます。削除はされないので、後から検索して補充することができます。

補充 — 買い直したら数量を1以上に戻してください。アイテムがアクティブな一覧に戻ります。

評価（投票） — 共有の家庭では、メンバーがアイテムに高評価・低評価を付けることができます。 もっと買うべきもの、もう誰も必要としないものを伝える手がかりになります。

開封・分割 — 開封したパッケージを開封済みとしてマークできます。複数あるうちの一部だけ を開封した場合（例：3本中1本）、Mottainaiは開封した分を別のエントリとして自動作成し、 元の数量から差し引きます。

賞味期限の管理 ​

賞味期限を登録したアイテムは、カレンダーの統合ビューに表示されます。他の予定と一緒に 期限切れが近いものを一覧で確認できます。また、今日・明日・今週中に期限が来るアイテムが ある場合は通知が届きます。

買い物リスト ​

各在庫には買い物リストが紐付いています。買う予定のものを登録し、買い物中にチェックを 入れるだけです。チェックすると：

  • 在庫のアイテムと紐付いている場合、在庫の数量が自動的に増えます。
  • 新しいアイテムの場合、その数量で在庫に新しいエントリが作成されます。

チェックを外すとチェック状態が解除されますが、在庫には影響しません。

リストを空にするを使うと、全アイテムをまとめて削除できます。

レシピをまるごと追加 — レシピから買い物リストに材料を一括で追加できます。 何人分か調整してから追加できるので、量がすでに計算済みの状態でリストに入ります。

AIによる補充提案 — Mottainaiが在庫の履歴を分析し、不足しているかもしれないアイテムを 提案します。

共有 ​

共有パネルから他の人を在庫に招待できます。招待リンクを送るか、メールアドレスで直接追加 することができます。

役割できること
オーナーすべての操作。削除不可。
管理者アイテムとメンバーの管理
メンバーアイテムの追加・編集（削除は不可）
ゲスト閲覧のみ

連絡先グループごと招待することもできます。グループ全員が一度にアクセスできるようになります。

開発者向け ​

以下のセクションは、CLI・AIアシスタント（MCP）・APIによるプログラムアクセス向けです。接続方法は MCP と CLI を参照してください。

CLI ​

bash
# 在庫コンテナ
mo storage list
mo storage create --name "Kitchen"
mo storage get STORAGE_ID
mo storage update STORAGE_ID --name "Main Kitchen"
mo storage delete STORAGE_ID --yes

# アイテム
mo item list STORAGE_ID
mo item create STORAGE_ID --title "Milk" --quantity 2 --unit L --expiration-date 2026-03-15
mo item update ITEM_ID --quantity 0          # アーカイブ
mo item update ITEM_ID --quantity 1          # 補充
mo item delete ITEM_ID --yes
mo item open ITEM_ID [--count 1] [--opened-at 2026-03-09]
mo item vote ITEM_ID --up
mo item batch-update STORAGE_ID --ids ID1,ID2 --category "Dairy"
mo item batch-delete STORAGE_ID --ids ID1,ID2 --yes

# 買い物リスト
mo shopping list SHOPPING_CONTAINER_ID
mo shopping add SHOPPING_CONTAINER_ID --title "Bread" [--quantity 2]
mo shopping update ITEM_ID --title "Sourdough bread"
mo shopping check ITEM_ID
mo shopping uncheck ITEM_ID
mo shopping delete ITEM_ID --yes
mo shopping clear SHOPPING_CONTAINER_ID --yes

# メンバーとグループ
mo storage member list STORAGE_ID
mo storage member add STORAGE_ID --email user@example.com --role member
mo storage member update-role STORAGE_ID USER_ID --role admin
mo storage member remove STORAGE_ID USER_ID --yes
mo storage group list STORAGE_ID
mo storage group link STORAGE_ID --group-id GROUP_ID
mo storage group unlink STORAGE_ID GROUP_ID --yes

# 招待リンク
mo storage invite-token STORAGE_ID

MCPツール ​

  • list_storages — 全在庫コンテナの一覧
  • create_storage — 在庫の新規作成
  • update_storage — 在庫の名前や設定を更新
  • delete_storage — 在庫の削除
  • list_storage_members — 在庫のメンバー一覧
  • add_storage_member — 在庫にメンバーを追加
  • remove_storage_member — 在庫からメンバーを削除
  • list_storage_items — アイテム一覧（フィールドフィルター対応）
  • create_storage_item — アイテムの新規作成
  • update_storage_item — アイテムの編集・アーカイブ・補充
  • delete_storage_item — アイテムの削除
  • open_storage_item — アイテムを開封済みにする（分割オプションあり）
  • vote_storage_item — アイテムを高評価・低評価する
  • check_storage_quota — 在庫の使用量をクォータ制限と照合
  • batch_update_items — 最大50件のアイテムを一括更新
  • batch_delete_items — 最大50件のアイテムを一括削除
  • list_shopping_items — 買い物リストのアイテム一覧
  • add_shopping_item — 買い物リストにアイテムを追加
  • update_shopping_item — 買い物アイテムの編集
  • delete_shopping_item — 買い物アイテムの削除
  • check_shopping_item — 買い物アイテムのチェック・解除（在庫同期）
  • batch_check_shopping_items — 最大50件を一括チェック
  • clear_shopping_list — 買い物リストの全アイテムを削除
  • add_recipe_to_shopping — レシピの材料を買い物リストに追加
  • list_labels / create_label / update_label / delete_label
  • link_item — 既存アイテムを別の在庫に紐付ける

APIエンドポイント ​

メソッドパス説明
GET/api/containers/{id}/items在庫アイテムの一覧
POST/api/containers/{id}/items在庫アイテムの作成
PUT/api/items/{itemId}?container={id}在庫アイテムの更新
DELETE/api/items/{itemId}?container={id}在庫アイテムの削除
POST/api/items/{itemId}/open?container={id}アイテムの開封・分割
POST/api/items/{itemId}/voteアイテムへの評価
POST/api/containers/{id}/batch-itemsアイテムの一括更新
POST/api/containers/{id}/batch-deleteアイテムの一括削除
GET/api/containers/{id}/locations保管場所とアイテム数の一覧
GET/api/containers/{id}/labelsラベルの一覧
POST/api/containers/{id}/labelsラベルの作成
GET/api/containers/{id}/membersメンバーの一覧
POST/api/containers/{id}/membersメンバーの追加
PUT/api/containers/{id}/members/{userId}メンバーの役割変更
DELETE/api/containers/{id}/members/{userId}メンバーの削除
POST/api/containers/{id}/ai/parseテキスト・画像からアイテムを抽出
POST/api/containers/{id}/ai/suggest補充提案の取得
GET/api/containers/{shoppingId}/items買い物リストの一覧
POST/api/containers/{shoppingId}/items買い物アイテムの追加
POST/api/items/{itemId}/check買い物アイテムのチェック・解除
DELETE/api/containers/{shoppingId}/items買い物リストの全削除
POST/api/containers/{shoppingId}/batch-check買い物アイテムの一括チェック

完全なAPIリファレンスは /api/docs を参照してください。

Copyright © 2026 Mottainai