AI から TODO を読み書きする(MCP)
MustDo MCP サーバーとは
MustDo の TODO を、Claude などの MCP 対応 AI クライアントから読み書きする仕組みです。読み書きするのは、iPhone のアプリと同じ、あなたの iCloud 上のレコードです。使い方は 2 つあります。
- 当社の中継サーバー(カスタムコネクタ)を通す — claude.ai と iPhone の Claude アプリから、誰でも使えます。通常はこちらを使ってください。中継サーバーは iCloud のサインイン用トークンだけを AWS KMS で暗号化して保管し、TODO の内容は保存せず、ログにも残しません
- 自分の Mac でサーバーを動かす — 開発者向けです。動かすのに必要な API Token を現在は一般には配布していません(このページの最後)
MCP を使うと、TODO の内容(タイトル・メモ・時刻など)があなたの選んだ AI クライアントに渡ります。渡したあとの取り扱いは、その AI クライアントのプライバシーポリシーに従います。詳しくはプライバシーポリシーの第7項。
必要なもの
- MustDo アプリを一度起動して iCloud に同期した Apple ID(iCloud 上の領域はアプリが作ります)
- MustDo の購読中、またはお試し期間中(期間が切れると
add_todoだけPAYMENT_REQUIREDになります。読み取り・完了・スヌーズは動きます)
claude.ai / iPhone の Claude アプリから使う(カスタムコネクタ)
claude.ai と iPhone の Claude アプリからは、当社の中継サーバー https://ltng.jp/api/mustdo/mcp を通して、下の一覧のうち 7 つのツールが使えます。Mac も、ソフトウェアのインストールも要りません。
- claude.ai で 設定 → コネクタ → カスタムコネクタを追加。名前は「MustDo」、URL に
https://ltng.jp/api/mustdo/mcpを入れて追加します - 「接続」を押すと ltng.jp の同意画面が開きます。当社サーバーが何を預かるか(iCloud のサインイン用トークンだけ。TODO の内容は保存しない)を確認して「Apple ID でサインインして接続」
- Apple の画面で、MustDo アプリで使っている Apple ID で iCloud にサインインします。claude.ai に戻れば完了です
- 一度接続すれば、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_todos | date か from/to(YYYY-MM-DD)と status(既定 pending)で絞る。繰り返しはテンプレートのまま返し、範囲内の回を添える |
add_todo | 追加。due は YYYY-MM-DDTHH:mm(あなたの時間帯)か ISO 8601 |
update_todo | 渡した項目だけ更新。repeat: null で繰り返しを外す |
complete_todo | 完了にする。繰り返しは「その日の回」だけ |
snooze_todo | until までスヌーズ |
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 以上で動く小さなプログラムです。
- 動かすには、MustDo のコンテナ用の CloudKit API Token が要ります。これはコンテナの持ち主(当社)しか発行できず、現在は一般には配布していません。そのため、通常は上のカスタムコネクタを使ってください
- ローカルで動かす場合、TODO のやり取りはあなたの Mac と Apple の間で行われます。サインインのときに限り、Apple からの戻りが当社のサーバー(
https://ltng.jp/api/mustdo/oauth/local-callback)を一度通りますが、そのとき受け取る情報は保存せず、ログにも残しません - 設定やツールの引数などの技術的な詳細は、リポジトリの README を見てください