Delete Reminder
delete_reminderDestructiveIdempotent
Delete any reminder by providing its unique ID. Removes the specified reminder from your reminders list.
Instructions
Delete a reminder by ID.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Reminder ID |
Implementation Reference
- src/reminders/tools.ts:326-352 (handler)The handler for the delete_reminder tool. Registers the tool with McpServer, defines input schema (id), and executes the deletion via runAutomation (Swift: 'delete-reminder' command or JXA fallback using deleteReminderScript). Returns a DeleteResult with {deleted: boolean, name: string}.
server.registerTool( "delete_reminder", { title: "Delete Reminder", description: "Delete a reminder by ID. This action is permanent.", inputSchema: { id: z.string().max(500).describe("Reminder ID"), }, annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false, }, }, async ({ id }) => { try { const result = await runAutomation<DeleteResult>({ swift: { command: "delete-reminder", input: { id } }, jxa: () => deleteReminderScript(id), }); return ok(result); } catch (e) { return errJxaFor("delete reminder", e); } }, ); - src/reminders/scripts.ts:166-174 (helper)The JXA (JavaScript for Automation) script that actually deletes a reminder using the Apple Reminders app. Finds the reminder by ID, captures its name, calls Reminders.delete(r), and returns a JSON with {deleted: true, name: name}.
export function deleteReminderScript(id: string): string { return ` const Reminders = Application('Reminders'); const r = Reminders.reminders.byId('${esc(id)}'); const name = r.name(); Reminders.delete(r); JSON.stringify({deleted: true, name: name}); `; } - src/shared/types.ts:12-15 (schema)The DeleteResult type definition used as the return type for delete_reminder. Contains {deleted: boolean, name: string}.
export interface DeleteResult { deleted: boolean; name: string; } - src/reminders/tools.ts:59-59 (registration)The export function registerReminderTools(server, config) that registers all reminder tools including delete_reminder on the McpServer.
export function registerReminderTools(server: McpServer, _config: AirMcpConfig): void {