Sky calendar
get_upcoming_eventsRead-only
Shows what changes in the sky over the coming days or weeks: planets changing sign, turning retrograde or direct, and new and full Moons, for up to 92 days. Supply from and to, and the person's time zone. With no arguments it opens the calendar for the next seven days. It does not list eclipses or every aspect.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | A moment as an ISO 8601 time with Z or an offset, such as 2026-10-08T09:00:00+07:00 (years 1800–2199). | |
| from | No | A moment as an ISO 8601 time with Z or an offset, such as 2026-10-08T09:00:00+07:00 (years 1800–2199). | |
| zone | No | The person's time zone, such as Asia/Bangkok or America/New_York. Without it, times are in UTC. | |
| kinds | No | ||
| bodies | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||