Zum Inhalt
Für Agenten

MCP Reference

agent_reminder_list_due

List Due Agent Reminders

Markdown Tools als JSON

Beschreibung

Call this at the very start of every session, before doing anything else. It returns the reminders you previously scheduled for yourself that are now due — i.e. due_at <= now, not yet completed, and created within the last 14 days. Reminders older than 14 days are auto-hidden so the inbox doesn't grow unbounded.

Sorted by due_at ascending — oldest-due first, so the most overdue work surfaces immediately.

Workflow per row: read the prompt, do the work, then call agent_reminder_upsert with the row's id and completed: true. If the situation changed and you want to defer instead, call agent_reminder_upsert with the same id and a new due_at.

Filters (all optional): - subject — exact match (e.g. "task:ENG-123"). - tags — match if the reminder has any of these tags. - limit — default 50, max 200.

Returns your own reminders only; other users' reminders are invisible.

Zugriff

Zugriffsprofil: gated. Module: none. Die Freigabe im Profil ersetzt keine Account-, Workspace- oder Rollenberechtigung.

Parameter

Name Typ Pflicht Beschreibung
account_id string Ja
subject string Nein
tags array Nein
limit integer Nein Max rows (default 50, max 200).

Eingabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "account_id": {
      "type": "string"
    },
    "subject": {
      "type": "string"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "description": "Max rows (default 50, max 200)."
    }
  },
  "required": [
    "account_id"
  ],
  "type": "object"
}

Ausgabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "reminders": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "prompt": {
            "type": "string"
          },
          "subject": {
            "type": [
              "string",
              "null"
            ]
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "due_at": {
            "type": "string"
          },
          "completed_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "created_at": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "prompt",
          "tags",
          "due_at",
          "created_at"
        ]
      }
    }
  },
  "required": [
    "reminders"
  ],
  "type": "object"
}
Seiten