gcal-pro

Reads a Google Calendar from the command line, listing today, tomorrow and the week, searching events and locating free slots, then adds event creation, rescheduling, deletion and a morning brief once a paid one-time licence is in place. The split is the main thing to know before adopting it: the free side covers looking, and every write operation including natural language quick add sits behind the upgrade. Setup is not trivial either, because the user must create a cloud project, download a client secret file into a specific config directory and complete an interactive browser consent once before the first command works.

Use case: Reading tomorrow's schedule before a standup

This skill puts a conversational layer over a calendar account, splitting what it can do by tier: reading the schedule is free, and changing it is not. A natural language request is translated into a small set of commands that handle viewing, searching and free time. ## What it does - Views the schedule for today, tomorrow, the week or the month. - Searches events by term. - Lists the calendars on the account. - Finds free time slots. - Adds, reschedules and deletes events and produces a morning brief on the paid tier. ## When it is the wrong choice The free tier is read only, so a request to create, move or delete an event hits a paywall rather than a permission problem, and the morning brief is locked behind the same tier. First time setup is not trivial either: it needs a cloud project and oauth credentials created by the account owner, with the client secret file placed at a specific path before the authorization step. That authorization opens a browser, so a headless first run cannot complete it. The commands are also run from the skill's own directory, and the helper reads its stored credentials from a fixed path, so the working directory matters. And the paid tier is per account, which means the cost scales with the number of calendars rather than with actual usage. ```bash python scripts/gcal_core.py today python scripts/gcal_core.py week python scripts/gcal_core.py free python scripts/gcal_core.py search -q "meeting" ``` ## Working notes - Reading and searching are available without the paid tier. - Writes and the morning brief require the paid tier. - Free time and search share the same read only commands.