MCP Apple Reminders

Implementation Reference

• src/index.ts:41-59 (handler)

  The handler function for the 'getReminders' MCP tool. It takes a listName parameter, fetches reminders using the helper, handles errors, and returns JSON-formatted reminders in MCP response format.
  async ({ listName }) => { try { const items = await reminders.getRemindersFromList(listName); return { content: [{ type: "text", text: JSON.stringify({ reminders: items }) }] }; } catch (error) { return { content: [{ type: "text", text: JSON.stringify({ error: `Failed to get reminders from list: ${listName}` }) }], isError: true }; } }
• src/index.ts:40-40 (schema)

  Input schema for the getReminders tool using Zod, requiring a 'listName' string parameter.
  { listName: z.string() },
• src/index.ts:38-59 (registration)

  Registration of the 'getReminders' tool on the MCP server, specifying name, input schema, and handler function.
  server.tool( "getReminders", { listName: z.string() }, async ({ listName }) => { try { const items = await reminders.getRemindersFromList(listName); return { content: [{ type: "text", text: JSON.stringify({ reminders: items }) }] }; } catch (error) { return { content: [{ type: "text", text: JSON.stringify({ error: `Failed to get reminders from list: ${listName}` }) }], isError: true }; } }
• src/reminders.ts:35-63 (helper)

  Supporting helper function that retrieves reminders from a specific list: finds list by name, calls node-reminders.getReminders, formats the output.
  export async function getRemindersFromList(listName: string): Promise<any[]> { 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 reminders from the list with specific properties const reminderItems = await reminders.getReminders( targetList.id, ['name', 'completed', 'dueDate', 'priority', 'body'] ); // Format the reminders to match the expected output format return reminderItems.map(item => ({ name: item.name, completed: item.completed || false, dueDate: formatDate(item.dueDate), priority: item.priority || 0, notes: item.body })); } catch (error) { console.error(`Failed to get reminders from list "${listName}":`, error); throw new Error(`Failed to get reminders from list "${listName}": ${error}`); } }