Skip to main content

Google Calendar

Google Calendar from the command line.

List, add, change and cancel events without leaving the terminal.

Calendar has two levels rather than four: read what is on it, or write to it. A client granted read can answer what a week looks like and cannot move anything in it.

Four commands

Each of the last three opens a browser tab, does one thing, and hands the terminal back.

curl -sSL https://gbrainio.terminalwire.sh | bash   # install it
gbrainio terminal connect                           # set the terminal up and connect it
gbrainio tool gcal open                             # connect the account
gbrainio terminal open                              # turn Google Calendar on for the terminal

The installer is a shell script for macOS and Linux. Read it before you run it.

Every Google Calendar command

This is gbrainio tool gcal, run for real. The page and the CLI print from the same code, so the cheatsheet is what the CLI answers to today.

gbrainio tool gcal
List, add, change and cancel events.

USAGE
  gbrainio tool gcal <command> [arguments]

COMMANDS
  event     ls, show, new, edit, rm, respond, move
  calendar  ls
  freebusy  Find a free slot
  open      Open its page in the browser

LEARN MORE
  gbrainio tool gcal <command> -h  What one command takes
  https://gbrain.io/docs/tools     The manual
gbrainio tool gcal event
Events on your calendars.

USAGE
  gbrainio tool gcal event <command> [arguments]

COMMANDS
  ls       See your events
  show     Read an event
  new      Add an event
  edit     Change an event
  rm       Remove an event
  respond  Answer an invitation
  move     Move an event

LEARN MORE
  gbrainio tool gcal event <command> -h  What one command takes
  https://gbrain.io/docs/tools           The manual
gbrainio tool gcal calendar
The calendars you can see.

USAGE
  gbrainio tool gcal calendar <command> [arguments]

COMMANDS
  ls  See your calendars

LEARN MORE
  gbrainio tool gcal calendar <command> -h  What one command takes
  https://gbrain.io/docs/tools              The manual

Same tools, any assistant

Claude Code, Cursor and Codex reach the same Google Calendar through MCP, on the same permission and the same record.

Google Calendar over MCP

How the whole thing fits

One permission, one daily ceiling, one record, across every client that asks.

Tools