> ## Documentation Index
> Fetch the complete documentation index at: https://pomeroy.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Reminders

> Your AI assistant can list your reminders, create one, and mark one done. It cannot delete a reminder, rename a list, or change a reminder after it is made.

Switch Reminders on and an assistant can see what is outstanding, add to it, and
tick things off.

<Columns cols={2}>
  <div>
    **Can**

    * List reminders, soonest due first, across every list or in one
    * Create a reminder, with notes and a due date if you give them
    * Mark a reminder done when you ask
  </div>

  <div>
    **Cannot**

    * Delete a reminder or a list
    * Change a reminder after it is created, other than marking it done
    * Create or rename lists
  </div>
</Columns>

## Tools

| Tool                 | What it does                                                                                                                                | Kind  |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
| `reminders_list`     | Lists reminders. Incomplete only by default, soonest due first; a reminder with no due date sorts last. Can be filtered to one list by name | Read  |
| `reminders_create`   | Creates a reminder and returns it as saved, with its id                                                                                     | Write |
| `reminders_complete` | Marks a reminder done by id and returns it as completed                                                                                     | Write |

## Try it

```text theme={null}
What's on my reminders?
Remind me to renew my passport next Friday.
What's due this week on my Work list?
Mark the dry cleaning one as done.
```

## Worth knowing

<AccordionGroup>
  <Accordion title="Completed reminders are hidden unless asked for" icon="eye-slash">
    `reminders_list` returns only incomplete reminders by default. An assistant
    has to ask for finished ones explicitly, so "what's outstanding?" does not
    come back padded with last month's.
  </Accordion>

  <Accordion title="Completing is safe to repeat" icon="check-double">
    Marking a reminder done twice does what doing it once did. Nothing is lost
    if an assistant retries.
  </Accordion>

  <Accordion title="You cannot un-complete one from here" icon="rotate-left">
    There is no tool for it. Reopen it in the Reminders app.
  </Accordion>
</AccordionGroup>

## Permissions

Switching Reminders on asks macOS for access to your reminders
(`NSRemindersFullAccessUsageDescription`). Reminders and Calendar are separate
prompts, even though both go through EventKit.