Use MustDo from AI clients (MCP)
What the MustDo MCP server is
A way for Claude and other MCP-capable AI clients to read and write your MustDo to-dos. What it reads and writes are the very same records in your iCloud that the iPhone app uses. There are two ways to use it.
- Through our relay server (a custom connector) — anyone can use it from claude.ai and the Claude app on iPhone. This is the one to use normally. The relay stores only your iCloud sign-in token, encrypted with AWS KMS; the content of your to-dos is never stored or written to logs
- Run the server on your own Mac — for developers. The API token it needs is not currently distributed to the public (see the end of this page)
When you use MCP, the contents of your to-dos (title, notes, time and so on) are passed to the AI client you chose. What happens to them after that is governed by that client’s privacy policy. See section 7 of the Privacy Policy.
Requirements
- An Apple ID that has opened the MustDo app at least once and synced to iCloud (the app creates the iCloud area)
- An active MustDo subscription or free trial (after it ends, only
add_todoreturnsPAYMENT_REQUIRED; reading, completing and snoozing keep working)
Using it from claude.ai / the Claude app on iPhone (custom connector)
claude.ai and the Claude app on iPhone can use seven of the tools listed below through our relay server at https://ltng.jp/api/mustdo/mcp. You need neither a Mac nor any software to install.
- In claude.ai open Settings → Connectors → Add custom connector. Name it “MustDo” and enter
https://ltng.jp/api/mustdo/mcpas the URL - Press “Connect”. A consent page on ltng.jp explains what our server keeps (only your iCloud sign-in token; never the content of your to-dos). Choose “Sign in with Apple ID and connect”
- On Apple’s page, sign in to iCloud with the Apple ID you use in the MustDo app. You are returned to claude.ai and the connector is ready
- Once connected, the same connector works in the Claude app on iPhone
The relay stores the token issued when you sign in to iCloud with your Apple ID, encrypted with AWS KMS in the AWS Tokyo region, and uses it to read and write your own iCloud on each request. So that the sign-in does not lapse while you are not using it, the relay also contacts Apple with this token about every 15 minutes to renew it (this never reads your to-dos), and stops doing so once you have not used the connector for 30 days. The content of your to-dos is never stored on the server or written to logs. See section 7 of the privacy policy.
Disconnecting: open https://ltng.jp/api/mustdo/disconnect and sign in with your Apple ID to verify it is you. The stored sign-in token is deleted immediately and every connection token issued for it stops working at once. Matching records (token hashes and the revocation record) disappear within 37 days, and copies in backups within 35 days. Removing the connector in claude.ai alone leaves our copy of the token in place, so do both when you stop using it. Your to-dos stay in iCloud untouched.
If Apple invalidates the iCloud sign-in, the tools return RECONNECT_REQUIRED. Reconnect from claude.ai Settings → Connectors → MustDo.
Tools
| Tool | What it does |
|---|---|
get_me | Trial/subscription state, time zone and today’s date |
list_todos | Filter by date or from/to (YYYY-MM-DD) and status (default pending). Repeating to-dos are returned as templates with the occurrences in range |
add_todo | Add a to-do. due is YYYY-MM-DDTHH:mm (your time zone) or ISO 8601 |
update_todo | Update only the fields you pass. repeat: null removes the repeat |
complete_todo | Mark as done. For repeating to-dos, only that day’s occurrence |
snooze_todo | Snooze until until |
delete_todo | Delete (physically removed from iCloud 14 days later) |
sign_in | (Local server on a Mac only) Opens Apple’s sign-in page and saves the sign-in data |
The custom connector offers the seven tools other than sign_in; the local server on a Mac offers all eight.
Errors come back as { "code": "...", "message": "..." }, where code is one of RECONNECT_REQUIRED / NOT_SIGNED_IN / NOT_CONFIGURED / PAYMENT_REQUIRED / NOT_FOUND / INVALID_ARGUMENT / CONFLICT / CLOUDKIT_ERROR. When the sign-in has expired, the custom connector returns RECONNECT_REQUIRED and the local server on a Mac returns NOT_SIGNED_IN.
Try it
Just ask Claude: “Add ‘take the medicine’ to MustDo for 9 AM tomorrow”, “Show me today’s to-dos”, “Snooze ‘buy milk’ for an hour”. As soon as iCloud is updated, the iPhone app wakes up through Apple’s silent push within seconds and reschedules the alarms.
Running it locally on a Mac (for developers)
The source code of the MCP server is published at https://github.com/lightning-llc-jpn/mustdo-mcp. It is a small program for Node.js 24 or later, used from Claude Code or Claude Desktop on a Mac.
- Running it requires a CloudKit API token for MustDo’s container. Only the owner of the container (us) can issue one, and we do not currently distribute it to the public. So please use the custom connector above for normal use
- When it runs locally, your to-dos travel between your Mac and Apple. Only during sign-in, the redirect back from Apple passes once through our server (
https://ltng.jp/api/mustdo/oauth/local-callback); what it receives is neither stored nor logged - For technical details such as configuration and tool arguments, see the README in the repository