list_reminders

Reminders & Microsoft To Do · macOS

Effect: read (strongest supported action). Status: gated.

Gated means the tool requires an installed app, a connected account, permission, or runtime availability. Check those requirements on the listed platform before using it.

macOS

Purpose

Lists reminders from Apple Reminders (Reminders.app) on this Mac. Optionally filter by completion status or list name. For Microsoft To Do use todo_list_tasks instead.

Required inputs

No required inputs are declared in this platform's schema. Optional selectors and runtime requirements may still apply.

Permissions and confirmation

No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.

Use only the apps, accounts and resources authorized by the user on this platform. Consult this tool's platform-specific description for its connection and permission requirements; this catalog does not assert additional OAuth scopes or OS entitlements.

Full input schema — macOS

{
  "properties": {
    "completed": {
      "description": "false or omitted = incomplete (the default). true = completed. There is no 'both': ask twice if you need them.",
      "type": "boolean"
    },
    "completed_since": {
      "description": "With completed=true: only reminders completed on or after this ISO 8601 date or datetime (optional). Applied before limit.",
      "type": "string"
    },
    "completed_until": {
      "description": "With completed=true: only reminders completed on or before this ISO 8601 date or datetime (optional). Inclusive when only a date is given: 2026-10-02 includes the whole of October 2. Applied before limit.",
      "type": "string"
    },
    "limit": {
      "description": "Max number of reminders to return (earliest due first). Optional; defaults to all.",
      "type": "integer"
    },
    "list_name": {
      "description": "Filter by reminder list name (optional)",
      "type": "string"
    },
    "offset": {
      "description": "Skip this many reminders first. A long answer is cut at 256 KB with truncated=true and next_offset: pass next_offset here to continue.",
      "type": "integer"
    }
  },
  "required": [],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "limit": 5
}