Mottainai Docs

日本語

English
Deutsch

日本語

English
Deutsch

Appearance

Als Markdown

カレンダー ​

TIP

カレンダーが他のツールの締め切りを取り込めることをご存知ですか？これらを組み合わせる方法は、**プロジェクト＆タスクガイド**で学ぶことができます。

Mottainaiのカレンダーは、予定の管理、リマインダーの設定、他のメンバーへの招待をひとつの場所でまとめて行える機能です。特に便利なのが統合ビューで、食材の賞味期限や在庫の期限切れ、ボードの期日、共有費用の支出日をカレンダー上に表示することができます。複数の機能を行き来しなくても、何が近づいているかを一目で把握できます。

はじめに： ダッシュボードからカレンダーを作成してください。ナビゲーションからアクセスできる統合ビューで、すべてのカレンダーを一覧できます。

表示モード ​

カレンダー上部のボタンで、6つの表示モードを切り替えられます。

  • 月表示 — 月全体をグリッドで表示し、各イベントが色付きのバーとして日付セルに表示されます。各日の予定の多さを一目で確認できます。
  • 週表示 — 1時間ごとのスロットがある7日間のグリッド表示です。終日イベントは上部のバナーに表示され、今日の日付はハイライトされます。
  • 3日表示 — 週表示と同じ構造ですが、3日間だけ表示されます。小さな画面や、より詳細に確認したいときに便利です。
  • 日表示 — 1日分を時間単位で詳しく表示します。任意の時間スロットをクリックすると、その時刻でイベントを作成できます。
  • アジェンダ — 今後のイベントを日時順のリストで表示し、タイトル・時刻・場所が一覧できます。グリッドではなく、予定だけをシンプルに確認できます。
  • メンバー表示 — カレンダーの全メンバーのスケジュールを横並びで表示します。全員の都合が合う時間を探すのに役立ちます。

イベントの作成 ​

日付セルや時間スロットをクリックすると、イベント作成フォームが開きます。入力できる項目は以下の通りです。

  • タイトル（必須）
  • 説明 — メモ、リンク、覚えておきたい情報など
  • 場所 — 部屋名、住所、会議URLなど
  • 色 — このイベントだけカレンダーの色とは別の色を設定できます
  • 終日 — 特定の時刻を持たない終日イベントとして設定します

新しいイベントにはカレンダーのデフォルト所要時間が自動的に適用されます。この設定はカレンダーの設定画面で変更できます。

繰り返しイベント ​

毎回手動で作成しなくても済むよう、イベントを繰り返し設定できます。毎日・毎週・毎月・毎年のほか、完全にカスタムのパターン（例：毎週月曜日と水曜日、または毎月第1月曜日）も設定できます。

繰り返しイベントを編集すると、Mottainaiは変更範囲を確認します。

  • このイベントのみ — クリックしたこの回だけを変更し、他は変更されません
  • これ以降のすべて — この回と、それ以降のすべての回を変更します
  • すべての回 — シリーズ全体を最初から最後まで変更します

繰り返しイベントを削除するときも、同じ3つの選択肢が表示されます。

参加者とリマインダー ​

参加者 — カレンダーのメンバーを特定のイベントに招待できます。招待された人は「承諾」「辞退」「仮承諾」のいずれかで返答できます。イベントの公開範囲を招待した参加者だけに限定することもでき、その場合はカレンダーの他のメンバーには表示されません。

リマインダー — イベントの前にプッシュ通知を届けるリマインダーを設定できます（例：15分前）。複数のリマインダーを異なる時間に設定することも可能です。各カレンダーには、新しいイベントに自動的に適用されるデフォルトのリマインダーを設定できます。

統合ビュー ​

ナビゲーションのカレンダーアイコンからアクセスできる統合ビューは、すべての情報をひとつのタイムラインにまとめて表示します。これはMottainaiならではの機能です。

  • すべてのカレンダー — メンバーになっているすべてのカレンダーのイベントが、カレンダーごとに色分けされてひとつに表示されます
  • 在庫の期限切れ — 賞味期限・消費期限が近い在庫アイテム（例：「牛乳の期限が切れます」）が終日イベントとして表示され、使い切るタイミングを逃しません
  • ボードの期日 — 期日が設定されたボードのカードがカレンダーに表示されます
  • SharedPayの支出日 — 共有費用グループに登録された支出日もここに表示されます

サイドバーのトグルで、各ソースのオン・オフを切り替えられます。個別のカレンダーを非表示にすることも、この画面から行えます。

過去のイベント管理 ​

イベントを作成するとき、終了後も保持するオプションを有効にできます。イベントが終わると、消えてしまう代わりに小さなタスクリストに移動します。イベントの作成・編集フォームで 「過去を保持」 オプションを有効にしてください。週次レビューや定期的な家事など、本当に実行したかどうかを確認したい繰り返しタスクに便利です。

過去のイベントに対して行える操作は2つです。

  • 完了としてマーク — アクティビティフィードに完了が記録されます
  • スキップ — 記録なしでリストから静かに削除されます

カレンダーの設定によって、誰か1人の操作でグループ全員に適用されるモードと、各メンバーが個別に完了を管理するモードを選択できます。

複数のカレンダー ​

カレンダーは必要なだけ作成できます。たとえば仕事用、家族用、プライベート用とそれぞれ分けて管理できます。カレンダーごとに色とメンバーを設定できます。

共有 ​

招待リンクで他のユーザーとカレンダーを共有できるほか、Mottainaiの連絡先から直接メンバーを追加することもできます。連絡先グループをリンクすると、グループ全員と一括で共有できます。

メンバーには4つのロールがあります：オーナー、管理者、メンバー、ゲスト。オーナーは削除できません。

開発者向け ​

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

CLI ​

bash
# カレンダー
mo calendar list
mo calendar create --name "Work" --color "#3b82f6" --week-start-day 1
mo calendar get CALENDAR_ID
mo calendar update CALENDAR_ID --name "Personal" --default-timezone "Europe/Berlin"
mo calendar delete CALENDAR_ID --yes

# イベント
mo calendar event list CALENDAR_ID --start 2026-03-01T00:00:00Z --end 2026-03-31T23:59:59Z
mo calendar event create CALENDAR_ID --title "Team sync" --start 2026-03-10T09:00:00Z --end 2026-03-10T10:00:00Z
mo calendar event create CALENDAR_ID --title "Standup" --start 2026-03-10T09:00:00Z --end 2026-03-10T09:15:00Z --rrule "FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR"
mo calendar event create CALENDAR_ID --title "Review" --start 2026-03-10T10:00:00Z --end 2026-03-10T11:00:00Z --keep-past --link-container BOARD_ID
mo calendar event update EVENT_ID --title "New title" --scope single --occurrence-date 2026-03-17
mo calendar event delete EVENT_ID --scope all --yes

# 過去のイベント
mo calendar past list
mo calendar past done EVENT_ID --occurrence-date 2026-03-10
mo calendar past dismiss EVENT_ID

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

# 招待リンク
mo calendar invite-token CALENDAR_ID

MCPツール ​

Mottainai MCPを使用したAIアシスタントで利用可能です。

  • list_calendars — メンバーになっているすべてのカレンダーを一覧表示
  • get_calendar — カレンダーの詳細と設定を取得
  • create_calendar — 新しいカレンダーを作成
  • update_calendar — 名前、色、タイムゾーンなどの設定を変更
  • delete_calendar — カレンダーとすべてのイベントを削除
  • list_calendar_events — 指定期間内のイベントを一覧表示
  • create_calendar_event — 繰り返し設定を含むすべてのフィールドでイベントを作成
  • update_calendar_event — イベントを更新（繰り返しイベントのスコープ指定に対応）
  • delete_calendar_event — イベントを削除（繰り返しイベントのスコープ指定に対応）
  • list_past_events — 対処待ちの過去のイベントを一覧表示
  • complete_past_event — 過去のイベントを完了またはスキップとしてマーク

繰り返しルール ​

繰り返しはRFC 5545準拠のRRULE文字列で定義します。例：

FREQ=DAILY;UNTIL=20261231
FREQ=WEEKLY;BYDAY=MO,WE,FR
FREQ=MONTHLY;BYDAY=1MO

パターンを細かく制御するための追加フィールド：

  • exdates — スキップする発生日のRFC3339タイムスタンプ配列
  • rdates — RRULEパターン外の追加発生日のRFC3339タイムスタンプ配列

編集・削除スコープ：all、single（occurrenceDateが必要）、following（occurrenceDateが必要）。

APIエンドポイント ​

メソッドパス説明
GET/api/calendarsカレンダー一覧
POST/api/calendarsカレンダー作成
GET/api/containers/{id}カレンダー取得
PUT/api/containers/{id}カレンダー更新
DELETE/api/containers/{id}カレンダー削除
GET/api/calendars/{id}/items期間内のイベント一覧
POST/api/calendars/{id}/itemsイベント作成
PUT/api/items/{eventId}イベント更新（?scope=&occurrenceDate=）
DELETE/api/items/{eventId}イベント削除（?scope=&occurrenceDate=）
GET/api/calendar/events統合ビューのイベント
GET/api/calendar/past-events対処待ちの過去のイベント
POST/api/calendar/past-events/{eventId}/action完了またはスキップ
GET/api/calendar/prefsユーザー設定取得
PUT/api/calendar/prefsユーザー設定更新
GET/api/containers/{id}/membersメンバー一覧
POST/api/containers/{id}/membersメンバー追加
PUT/api/containers/{id}/members/{userId}メンバーロール変更
DELETE/api/containers/{id}/members/{userId}メンバー削除

統合ビューのクエリ制限：リクエストあたり最大366日、最大3,000件のイベント、繰り返しシリーズあたり最大500件。

完全なAPIリファレンスは /api/docs で確認できます。

Copyright © 2026 Mottainai