MCP Apple Reminders

Implementation Reference

• src/index.ts:127-145 (handler)

  MCP tool handler for 'deleteReminder' that delegates to the reminders.deleteReminder helper function and formats the response as MCP content.

  async ({ listName, reminderName }) => {
    try {
      const success = await reminders.deleteReminder(listName, reminderName);
      return {
        content: [{ 
          type: "text", 
          text: JSON.stringify({ success, message: success ? "Reminder deleted" : "Reminder not found" }) 
        }]
      };
    } catch (error) {
      return {
        content: [{ 
          type: "text", 
          text: JSON.stringify({ error: "Failed to delete reminder" }) 
        }],
        isError: true
      };
    }
  }

• src/index.ts:123-126 (schema)

  Zod input schema validating listName and reminderName parameters for the deleteReminder tool.

  { 
    listName: z.string(),
    reminderName: z.string()
  },

• src/index.ts:121-146 (registration)

  Registration of the 'deleteReminder' tool with the MCP server using server.tool().

  server.tool(
    "deleteReminder",
    { 
      listName: z.string(),
      reminderName: z.string()
    },
    async ({ listName, reminderName }) => {
      try {
        const success = await reminders.deleteReminder(listName, reminderName);
        return {
          content: [{ 
            type: "text", 
            text: JSON.stringify({ success, message: success ? "Reminder deleted" : "Reminder not found" }) 
          }]
        };
      } catch (error) {
        return {
          content: [{ 
            type: "text", 
            text: JSON.stringify({ error: "Failed to delete reminder" }) 
          }],
          isError: true
        };
      }
    }
  );

• src/reminders.ts:142-173 (helper)

  Helper function implementing the core logic to delete a specific reminder from a list by finding the list ID, reminder ID, and calling the node-reminders library's deleteReminder.

  export async function deleteReminder(listName: string, reminderName: string): Promise<boolean> {
    try {
      // First get the list ID by name
      const lists = await reminders.getLists();
      const targetList = lists.find(list => list.name === listName);
      
      if (!targetList) {
        throw new Error(`List "${listName}" not found`);
      }
      
      // Get all reminders from the list
      const reminderItems = await reminders.getReminders(
        targetList.id,
        ['name', 'id']
      );
      
      // Find the specific reminder by name
      const targetReminder = reminderItems.find(item => item.name === reminderName);
      
      if (!targetReminder) {
        return false; // Reminder not found
      }
      
      // Delete the reminder
      await reminders.deleteReminder(targetReminder.id);
      
      return true;
    } catch (error) {
      console.error(`Failed to delete reminder "${reminderName}" in list "${listName}":`, error);
      throw new Error(`Failed to delete reminder: ${error}`);
    }
  }