Schedules

ID	session_schedule
Category	Session
Features	schedules (unlocks Schedules tab)
Dependencies	None

Schedule future tasks within the current session. Supports one-shot (run once at a specific time) and recurring (cron expression) schedules.

Tools

create_schedule

Create a new scheduled task.

Parameter	Type	Required	Description
message	string	yes	The message/task to execute
scheduled_at	string	conditional	ISO 8601 datetime for one-shot schedules
cron_expression	string	conditional	Cron expression for recurring schedules

Provide either scheduled_at or cron_expression, not both.

cancel_schedule

Cancel an active schedule.

Parameter	Type	Required	Description
schedule_id	string	yes	ID of the schedule to cancel

list_schedules

List all schedules for the current session.

Notes

• Maximum 5 active schedules per session
• Cron uses standard 5-field format (minute, hour, day, month, weekday)
• Scheduled messages are sent to the session as if the user sent them
• Use Current Time to determine “now” before scheduling

See Also

• Current Time — get current time for scheduling context
• Session — session metadata
• Capabilities Overview