MCP Reminders

Instructions

Implementation Reference

• src/index.ts:340-346 (handler)

  Handler for the 'remind_me' tool in the CallToolRequestSchema switch statement. Extracts parameters and delegates to ReminderManager.addReminder, returning the generated ID.

  case 'remind_me': {
    const { reminder, priority } = args as { reminder: string; priority?: 'high' | 'normal' | 'low' };
    const id = reminders.addReminder(reminder, priority);
    return {
      content: [{ type: 'text', text: `Reminder added: ${id}` }],
    };
  }

• src/index.ts:231-249 (registration)

  Tool registration in ListToolsRequestSchema response, defining name, description, and input schema for 'remind_me'.

  {
    name: 'remind_me',
    description: 'Add a reminder',
    inputSchema: {
      type: 'object',
      properties: {
        reminder: {
          type: 'string',
          description: 'What to remember'
        },
        priority: {
          type: 'string',
          enum: ['high', 'normal', 'low'],
          description: 'Priority level (default: normal)'
        }
      },
      required: ['reminder'],
    },
  },

• src/index.ts:234-248 (schema)

  Input schema definition for the 'remind_me' tool, specifying required 'reminder' string and optional 'priority' enum.

  inputSchema: {
    type: 'object',
    properties: {
      reminder: {
        type: 'string',
        description: 'What to remember'
      },
      priority: {
        type: 'string',
        enum: ['high', 'normal', 'low'],
        description: 'Priority level (default: normal)'
      }
    },
    required: ['reminder'],
  },

• src/index.ts:111-124 (helper)

  Core helper method in ReminderManager class that creates, stores, and persists a new reminder, generating a unique ID.

  addReminder(content: string, priority: 'high' | 'normal' | 'low' = 'normal'): string {
    const id = `rem_${Date.now()}_${Math.random().toString(36).substr(2, 5)}`;
    const reminder: Reminder = {
      id,
      content,
      priority,
      created: new Date().toISOString(),
      status: 'active'
    };
    
    this.reminders.set(id, reminder);
    this.saveReminders();
    return id;
  }