MCP Reminders

Instructions

Implementation Reference

• src/index.ts:405-409 (handler)

  Handler for the 'help' tool. Returns the predefined HELP_DOCUMENTATION as a text content block in the tool response.

  case 'help': {
    return {
      content: [{ type: 'text', text: HELP_DOCUMENTATION }],
    };
  }

• src/index.ts:323-330 (registration)

  Registration of the 'help' tool in the list of tools returned by ListToolsRequestHandler, including name, description, and empty input schema.

  {
    name: 'help',
    description: 'Get help on using reminders',
    inputSchema: {
      type: 'object',
      properties: {},
    },
  },

• src/index.ts:13-68 (helper)

  Helper constant containing the full documentation text returned by the 'help' tool.

  const HELP_DOCUMENTATION = `
  # MCP Reminders Server
  
  A simple reminder system for Claude - like "Alexa, remind me..." but for AI.
  Leave notes for yourself across sessions, check them when you start, act on them or save them.
  
  ## Available Functions:
  
  ### remind_me(reminder, priority?)
  Add a reminder to the queue.
  - reminder: What to remember
  - priority: "high", "normal", "low" (default: "normal")
  Returns: Reminder ID
  
  ### check_reminders(filter?)
  Check your reminders.
  - filter: Optional - "all", "high", "normal", "low" (default: "all")
  Returns: List of reminders sorted by priority and time
  
  ### complete_reminder(id)
  Mark a reminder as completed/handled.
  - id: Reminder ID
  Returns: Confirmation
  
  ### delete_reminder(id)
  Delete a reminder without completing it.
  - id: Reminder ID
  Returns: Confirmation
  
  ### move_to_notes(id, note?)
  Move a reminder to permanent notes (Obsidian).
  - id: Reminder ID
  - note: Optional additional note
  Returns: Confirmation
  
  ### clear_old_reminders(days?)
  Clear reminders older than N days.
  - days: Number of days (default: 7)
  Returns: Number cleared
  
  ### help()
  Show this documentation.
  
  ## Usage Pattern:
  1. Start session: check_reminders()
  2. See what needs attention
  3. Work on items, then complete_reminder(id)
  4. Important items: move_to_notes(id)
  5. Clean up: clear_old_reminders()
  
  ## Examples:
  - remind_me("Test the new contemplation loop integration", "high")
  - remind_me("Look into why AppleScript restart lost context")
  - check_reminders("high")
  - complete_reminder("rem_12345")
  `;