# MustDo [Health: Active]

**Category:** 🏢 Workplace & Productivity  
**Repository:** https://github.com/lightning-llc-jpn/mustdo-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mustdo

## Description
Read and write your MustDo (iOS alarm To-Do) tasks in your own iCloud via CloudKit.

## Tools
Capabilities this server exposes over MCP:

- **sign_in** — Local only.** Opens Apple's sign-in page and stores `ckWebAuthToken`. Not present on the relay.
- **get_me** — Account info: `timeZone`, `today`, `weekday`, `defaultTime`, `defaultDueNext`, trial/subscription dates, `canAddTodo`. Call this before doing date math.
- **list_todos** — Lists To-Dos. Deleted ones are excluded. Repeating To-Dos are returned as **templates** under `repeating` (not expanded) with any per-day `occurrences` in range.
- **add_todo** — Creates a To-Do with `source = "mcp"`. **If `due` is omitted, it is tomorrow at the default time.
- **update_todo** — Changes only the fields you pass. `repeat` replaces the whole rule; `null` or `{ "kind": "none" }` removes it.
- **complete_todo** — One-off: `status = done`. Repeating: marks that day's occurrence done (default: today).
- **snooze_todo** — Snoozes until `until`. Repeating: only that day's occurrence.
- **delete_todo** — Soft delete (`deletedAt`). The app purges it after 14 days.

## Claude Desktop Quick Installation
No confirmed install details yet, so no config is published. Follow the setup steps in the repository above.

## Documentation

## What MustDo does

MustDo MCP server gives an MCP client read and write access to tasks managed by the MustDo iOS app. The data remains in the Apple ID's private CloudKit database, in the MustDo container and zone used by the app. The server does not maintain a separate To-Do database, and writes are followed by a CloudKit silent notification so the iPhone app can refresh.

The MustDo MCP server fits workflows where an agent needs to inspect reminders, create new alarm To-Dos, adjust existing tasks, mark work complete, postpone an occurrence, or remove an item. It belongs in the Workplace & Productivity category, although its data source is a personal iOS app and iCloud account.

## How it works

The hosted relay exposes a remote MCP endpoint at `https://ltng.jp/api/mustdo/mcp`. During connection, the user signs in with the same Apple ID used by MustDo. The relay stores the CloudKit web authentication token encrypted with AWS KMS so it can make requests, but it does not store or log To-Do content, the Apple ID email, or the password.

The local implementation uses stdio and calls Apple's CloudKit Web Services. Its local sign-in flow opens an Apple page, receives the callback on port 51234, and saves the resulting session token under the MustDo home directory. `get_me` reports the account time zone, current date, default alarm time, and related account state. Date-only inputs are interpreted using that account context. If `due` is omitted when adding a task, the due time is tomorrow at the account's default time.

## Setup and configuration

For the hosted option, add the relay as a custom connector in claude.ai, connect it, and complete Apple sign-in. The same connector can be used in the Claude iPhone app. To run locally, use macOS with Node.js 24 or newer, install the MustDo app, clone the repository, run `npm install`, and build with `npm run build`.

Local use requires a CloudKit API token for the MustDo container. The README states that this token is not publicly distributed, so general users should use the hosted relay. Configuration can be supplied through environment variables or `~/.mustdo/config.json`; environment variables take precedence. Local authentication is stored in `auth.json` with restrictive file permissions.

## Tools and capabilities

The MustDo MCP server provides tools for:

- Reading account details with `get_me`.
- Listing pending, completed, skipped, or all non-deleted To-Dos.
- Creating and updating titles, due dates, notes, sounds, status, and repeat rules.
- Completing or snoozing one-off tasks and individual repeating occurrences.
- Soft-deleting tasks; the app permanently purges them after 14 days.

Repeating tasks are returned as templates with any matching occurrences, rather than as an expanded list of every repetition.

## Limitations and notes

The local `sign_in` tool is not available through the hosted relay. Apple session credentials can expire; when that happens, the client must authenticate again. Repeating-task operations require care because completion and snoozing apply to a specific occurrence, defaulting to today when applicable. Deleted tasks are excluded from listings. Disconnecting the hosted connector and visiting the documented disconnect endpoint removes the stored relay token after Apple confirmation.

_Full upstream README: https://allmcps.com/mcp/mustdo/readme_