Skip to main content
Max ships with a bundled gogcli skill that teaches it how to use the gog command-line tool. Once you authenticate, Max can read your inbox, check your calendar, search Drive, manage contacts, complete tasks, and read or update Sheets — all from natural language.
Google services integration is entirely optional. Max works without it.

​
What you can do after setup

Gmail

Search, read, send, reply to, and draft emails. Manage labels and threads.

Calendar

List events, create meetings, check free/busy time, RSVP to invitations.

Drive

Search and list files, download or upload documents, share files, create folders.

Contacts

Search, list, and create Google Contacts.

Tasks

List task lists, add tasks, and mark tasks as done.

Sheets

Read cell ranges and update values in Google Sheets.

​
Setup

1

Install gogcli

Install the gog CLI with Homebrew:
brew install steipete/tap/gogcli
Verify the install:
gog --version
2

Create Google OAuth credentials

gog authenticates using an OAuth 2.0 Desktop app credential you create in Google Cloud:
  1. Go to https://console.cloud.google.com/apis/credentials.
  2. Create a project if you don’t have one.
  3. Enable the APIs you want to use (Gmail API, Google Calendar API, Google Drive API, etc.).
  4. Configure the OAuth consent screen (External, your own email as a test user).
  5. Create an OAuth client — choose type Desktop app.
  6. Download the JSON credentials file.
Store the credentials file so gog can find it:
gog auth credentials ~/Downloads/client_secret_....json
3

Authenticate with your Google account

Run the auth command with the email address you want to grant access:
gog auth add your-email@gmail.com
This opens a browser window for the standard Google OAuth consent flow. After you approve, gog stores a refresh token locally — you won’t need to re-authenticate.Check the auth status at any time:
gog auth status
4

Start Max

Max automatically loads the bundled gogcli skill when it starts. No extra configuration is needed:
max start
The skill is read from the package’s bundled skills/gogcli/ directory and injected into Max’s system prompt at session creation time.
5

Test it

Open the TUI or Telegram and ask Max something that requires Google access:
What's in my inbox?

What do I have on my calendar today?

Search Drive for quarterly report.
Max will run the appropriate gog command and return the results.

​
What the gogcli skill teaches Max

The skill is a SKILL.md file bundled with Max at skills/gogcli/SKILL.md. It tells Max:
  • When to use it — whenever you ask about email, calendar, Drive, contacts, or any Google service.
  • Required flags — --json for parseable output, --no-input to prevent the CLI from hanging, -a email to target a specific account.
  • Command syntax — the exact gog subcommands for every supported operation (Gmail search, calendar event creation, Drive file upload, etc.).
  • Error handling — how to detect when gog is not installed or not authenticated, and how to guide you through setup.
Max reads these instructions at startup and decides when and how to invoke gog commands based on what you ask.

​
Key commands Max uses

# Search unread emails
gog gmail search "is:unread" --json

# Read a specific message
gog gmail get <messageId> --json

# Send an email
gog send --to "recipient@example.com" --subject "Hello" --body "Message body"

# Reply to a thread
gog gmail messages reply <messageId> --body "Reply text"

​
Multiple Google accounts

If you have more than one Google account authenticated, use the -a flag to specify which one: 
gog gmail search "is:unread" -a work@example.com --json
Check which accounts are authenticated: 
gog auth status

​
Troubleshooting

Run gog --version to confirm the CLI is on your PATH. If the command is not found, reinstall:
brew install steipete/tap/gogcli
Run gog auth status to check which accounts are active. If no accounts are listed, re-authenticate:
gog auth add your-email@gmail.com
You may not have enabled the relevant Google API in your Cloud project. Go to the API library in Google Cloud Console and enable the API (Gmail API, Google Calendar API, etc.), then re-authenticate.
Re-run the credentials command, pointing to your downloaded JSON file:
gog auth credentials ~/Downloads/client_secret_....json

Build docs developers (and LLMs) love

Get started for freeTalk to us