MCP Reminders

Instructions

Implementation Reference

• src/index.ts:397-403 (handler)

  MCP CallToolRequestSchema handler case for 'clear_old_reminders' that extracts 'days' parameter, calls ReminderManager.clearOldReminders, and returns the number of cleared reminders.

  case 'clear_old_reminders': {
    const { days } = args as { days?: number };
    const count = reminders.clearOldReminders(days);
    return {
      content: [{ type: 'text', text: `Cleared ${count} old reminders.` }],
    };
  }

• src/index.ts:311-322 (schema)

  Tool schema definition including name, description, and input schema for optional 'days' parameter.

    name: 'clear_old_reminders',
    description: 'Clear old completed/moved reminders',
    inputSchema: {
      type: 'object',
      properties: {
        days: {
          type: 'number',
          description: 'Clear items older than N days (default: 7)'
        }
      },
    },
  },

• src/index.ts:196-209 (helper)

  Core logic in ReminderManager class that deletes non-active reminders older than specified days and returns the count.

  clearOldReminders(days: number = 7): number {
    const cutoff = Date.now() - (days * 24 * 60 * 60 * 1000);
    let count = 0;
    
    for (const [id, reminder] of this.reminders) {
      if (reminder.status !== 'active' && new Date(reminder.created).getTime() < cutoff) {
        this.reminders.delete(id);
        count++;
      }
    }
    
    if (count > 0) this.saveReminders();
    return count;
  }