todoist_reminders
Set and manage task reminders in Todoist using relative time, specific dates, or location-based triggers to help users stay on top of deadlines and commitments.
Instructions
Manage reminders for Todoist tasks. Supports three reminder types: relative (minutes before task due date), absolute (specific date and time), and location (geofenced area). Natural language due dates supported (e.g., "tomorrow at 10:00", "every day", "every 4th").
Input Schema
Name | Required | Description | Default |
---|---|---|---|
action | Yes | Action to perform on reminders | |
due | No | Due date object for absolute reminders (supports natural language) | |
item_id | No | Task ID for which the reminder is set | |
loc_lat | No | Latitude (location reminders only) | |
loc_long | No | Longitude (location reminders only) | |
loc_trigger | No | Trigger type for location reminders | |
minute_offset | No | Minutes before task due date (relative reminders only, max 43200 = 30 days) | |
name | No | Location name (location reminders only) | |
notify_uid | No | User ID to notify (optional) | |
radius | No | Radius in meters (location reminders only, max 5000) | |
reminder_id | No | Reminder ID for get/update/delete operations | |
type | No | Type of reminder: relative (minutes before due), absolute (specific datetime), location (geofenced) |
Input Schema (JSON Schema)
{
"properties": {
"action": {
"description": "Action to perform on reminders",
"enum": [
"create",
"get",
"update",
"delete",
"list"
],
"type": "string"
},
"due": {
"description": "Due date object for absolute reminders (supports natural language)",
"properties": {
"date": {
"description": "ISO 8601 datetime",
"type": "string"
},
"is_recurring": {
"description": "Whether reminder repeats",
"type": "boolean"
},
"lang": {
"description": "Language for parsing (default: en)",
"type": "string"
},
"string": {
"description": "Natural language date",
"type": "string"
},
"timezone": {
"description": "Timezone for due date",
"type": "string"
}
},
"type": "object"
},
"item_id": {
"description": "Task ID for which the reminder is set",
"type": "string"
},
"loc_lat": {
"description": "Latitude (location reminders only)",
"type": "string"
},
"loc_long": {
"description": "Longitude (location reminders only)",
"type": "string"
},
"loc_trigger": {
"description": "Trigger type for location reminders",
"enum": [
"on_enter",
"on_leave"
],
"type": "string"
},
"minute_offset": {
"description": "Minutes before task due date (relative reminders only, max 43200 = 30 days)",
"type": "number"
},
"name": {
"description": "Location name (location reminders only)",
"type": "string"
},
"notify_uid": {
"description": "User ID to notify (optional)",
"type": "string"
},
"radius": {
"description": "Radius in meters (location reminders only, max 5000)",
"type": "number"
},
"reminder_id": {
"description": "Reminder ID for get/update/delete operations",
"type": "string"
},
"type": {
"description": "Type of reminder: relative (minutes before due), absolute (specific datetime), location (geofenced)",
"enum": [
"relative",
"absolute",
"location"
],
"type": "string"
}
},
"required": [
"action"
],
"type": "object"
}