Roadmap
See which Google Calendar CLI capabilities are available and which work remains planned.
This page lists what is planned for gcal and is not in it yet. Read it before you build a workaround for a missing
feature: it may already be on the way. The order is approximate and can change. To suggest something, open an
issue on GitHub.
What works today
gcal signs in to your Google account and syncs the calendars you own into the local WireCat store, from a year back
to three months ahead, then only what changed; a big sync goes on over several runs. You can list, show and search
events by words and by meaning, see the people in them and their Drive files, all without the network, and search
Google Calendar itself with search --backend server. calendars busy shows when people are taken and the stretches
free for all of them. After session start --grant write it creates, changes and deletes events, repeating ones
included, switches an event between timed and all-day, and answers invitations, each write asking first. gcal api
reaches every Google Calendar API method by name. Every command is in the command reference.
Next
- Moving an event to another calendar. Today: create it on the other calendar and delete the old one.
- Changing "this and all following" occurrences of a repeating event. Today a change applies to one occurrence or
to the whole series (
--series). - Sign-in without your own Google client.
gcaluses WireCat's shared Google app once Google has reviewed it for Calendar. Until then, make your own client.
What each released version changed is in the changelog.