Set work package reminder
set_work_package_reminderSet, change, or clear your private reminder on a work package. Get notified at your chosen time with an optional note.
Instructions
Set, change or clear your personal reminder on a work package.
Use this when something should resurface later: "remind me about this on
Monday", "ping me an hour before the release". Reminders are private —
only you see yours, and only you are notified. The tool upserts: it looks
for your active reminder on the work package and creates one if there is
none, updates it if there is. Returns action
(created/updated/deleted/unchanged) and the resulting reminder.
Passing remind_at=null deletes the reminder. That is the
documented way to clear it rather than a destructive operation — nothing
but your own pending notification is removed, the work package and its
history are untouched — so this tool does not ask for confirm. Set a
new time to get it back.
Pitfalls. OpenProject allows exactly one active reminder per work package
per person, so a second "create" becomes an update of the first — there
is no way to stack two. remind_at must carry a timezone; a bare
'2026-08-03T09:00' is refused rather than guessed at. A reminder in the
past is rejected by the instance. Once a reminder has fired it disappears
from the API, so a later call creates a fresh one rather than reviving
it. Reminders are personal: you cannot set one for a colleague — add them
as a watcher or mention them in a comment instead.
Cross-references: list_reminders shows everything you have pending;
add_work_package_watcher notifies someone about changes rather than
at a chosen time; add_work_package_comment with an @-mention is how
you get another person's attention.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | Short text shown with the reminder ('check the staging deploy'). Omit to leave an existing note untouched; pass an empty string to clear it. | |
| remind_at | No | When to be reminded, as an ISO 8601 datetime WITH a timezone, e.g. '2026-08-03T09:00:00Z'. Pass null to delete the existing reminder. Omit the parameter entirely to keep the current time and only change the note. | __unchanged__ |
| work_package_id | Yes | Work package to be reminded about. Ids come from search_work_packages, list_work_packages or get_work_package. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | What actually happened: 'created' a new reminder, 'updated' the existing one, 'deleted' it, or 'unchanged' when there was nothing to clear. | |
| message | Yes | Human-readable confirmation. | |
| reminder | No | The reminder after the call; the deleted one when action='deleted', null when there was none. | |
| work_package_id | Yes | Work package whose reminder was set or cleared. |