AI から TODO を読み書きする(MCP)

公開・ 更新

MustDo MCP サーバーとは

MustDo の TODO を、Claude などの MCP 対応 AI クライアントから読み書きする仕組みです。読み書きするのは、iPhone のアプリと同じ、あなたの iCloud 上のレコードです。使い方は 2 つあります。

  1. 当社の中継サーバー(カスタムコネクタ)を通す — claude.ai と iPhone の Claude アプリから、誰でも使えます。通常はこちらを使ってください。中継サーバーは iCloud のサインイン用トークンだけを AWS KMS で暗号化して保管し、TODO の内容は保存せず、ログにも残しません
  2. 自分の Mac でサーバーを動かす — 開発者向けです。動かすのに必要な API Token を現在は一般には配布していません(このページの最後)

MCP を使うと、TODO の内容(タイトル・メモ・時刻など)があなたの選んだ AI クライアントに渡ります。渡したあとの取り扱いは、その AI クライアントのプライバシーポリシーに従います。詳しくはプライバシーポリシーの第7項。

必要なもの

claude.ai / iPhone の Claude アプリから使う(カスタムコネクタ)

claude.ai と iPhone の Claude アプリからは、当社の中継サーバー https://ltng.jp/api/mustdo/mcp を通して、下の一覧のうち 7 つのツールが使えます。Mac も、ソフトウェアのインストールも要りません。

  1. claude.ai で 設定 → コネクタ → カスタムコネクタを追加。名前は「MustDo」、URL に https://ltng.jp/api/mustdo/mcp を入れて追加します
  2. 「接続」を押すと ltng.jp の同意画面が開きます。当社サーバーが何を預かるか(iCloud のサインイン用トークンだけ。TODO の内容は保存しない)を確認して「Apple ID でサインインして接続」
  3. Apple の画面で、MustDo アプリで使っている Apple ID で iCloud にサインインします。claude.ai に戻れば完了です
  4. 一度接続すれば、iPhone の Claude アプリでも同じコネクタがそのまま使えます

中継サーバーは、Apple ID で iCloud にサインインしたときのトークンを AWS 東京リージョンで AWS KMS により暗号化して保管し、リクエストのたびに利用者自身の iCloud を読み書きします。使っていない間にサインインが切れないよう、約 15 分おきにこのトークンで Apple に接続し、トークンを新しくします(TODO は読みません)。コネクタを 30 日使わなければ、この更新はやめます。TODO の内容はサーバーに保存せず、ログにも残しません。詳しくはプライバシーポリシーの第7項。

接続解除: https://ltng.jp/api/mustdo/disconnect を開き、Apple ID でサインインして本人確認すると、当社サーバーに保管したサインイン用トークンが即時に削除され、発行済みの接続用トークンはその場で使えなくなります。照合用の記録(接続用トークンのハッシュ値と、無効にした記録)は最長 37 日、バックアップに含まれる分は最長 35 日で消えます。claude.ai 側のコネクタを削除するだけでは当社側のトークンは残るので、やめるときは両方行ってください。TODO は iCloud にそのまま残ります。

iCloud のサインインが Apple 側で失効すると、ツールが RECONNECT_REQUIRED を返します。claude.ai の設定 → コネクタ → MustDo から接続し直してください。

ツール一覧

ツール何をする
get_meお試し・購読の状態、時間帯、今日の日付
list_todosdate か from/to(YYYY-MM-DD)と status(既定 pending)で絞る。繰り返しはテンプレートのまま返し、範囲内の回を添える
add_todo追加。due は YYYY-MM-DDTHH:mm(あなたの時間帯)か ISO 8601
update_todo渡した項目だけ更新。repeat: null で繰り返しを外す
complete_todo完了にする。繰り返しは「その日の回」だけ
snooze_todountil までスヌーズ
delete_todo削除(14 日後に iCloud から物理削除)
sign_in(Mac のローカルサーバーのみ)Apple のサインイン画面を開いてサインイン情報を保存

カスタムコネクタで使えるのは sign_in を除く 7 つ、Mac のローカルサーバーは sign_in を足した 8 つです。

エラーは { "code": "...", "message": "..." } の形で返ります。code は RECONNECT_REQUIRED / NOT_SIGNED_IN / NOT_CONFIGURED / PAYMENT_REQUIRED / NOT_FOUND / INVALID_ARGUMENT / CONFLICT / CLOUDKIT_ERROR。サインインが切れたとき、カスタムコネクタは RECONNECT_REQUIRED を、Mac のローカルサーバーは NOT_SIGNED_IN を返します。

使ってみる

Claude に、たとえば「明日の 9 時に『薬を飲む』を MustDo に入れて」「今日の TODO を見せて」「『牛乳を買う』を 1 時間後にスヌーズして」と頼むだけです。iCloud に書き込まれると、iPhone のアプリが Apple のサイレントプッシュで数秒以内に起き、アラームを登録し直します。

Mac でローカルに動かす(開発者向け)

MCP サーバーのソースコードは https://github.com/lightning-llc-jpn/mustdo-mcp で公開しています。Mac の Claude Code や Claude Desktop から使う、Node.js 24 以上で動く小さなプログラムです。

あわせて読む