Access Gmail, Calendar, Drive, Contacts, Sheets, and Docs via the gogcli CLI.
Prerequisites
brew install steipete/tap/gogcli
Authenticate:
gogcli auth login
This opens a browser for Google OAuth. Grant the requested scopes. Confirm with:
gogcli auth status
Commands
Gmail
| Command | Description |
|---|---|
gogcli gmail list |
List inbox messages |
gogcli gmail read <id> |
Read a message |
gogcli gmail send --to "..." --subject "..." --body "..." |
Send an email |
gogcli gmail reply <id> --body "..." |
Reply to a message |
gogcli gmail search "<query>" |
Search emails (Gmail syntax) |
gogcli gmail archive <id> |
Archive a message |
gogcli gmail trash <id> |
Move to trash |
Calendar
| Command | Description |
|---|---|
gogcli calendar list |
List upcoming events |
gogcli calendar list --days 7 |
Events in next 7 days |
gogcli calendar create --title "..." --start "..." --end "..." |
Create an event |
gogcli calendar delete <id> |
Delete an event |
gogcli calendar search "<query>" |
Search events |
Drive
| Command | Description |
|---|---|
gogcli drive list |
List files in Drive root |
gogcli drive search "<query>" |
Search files |
gogcli drive download <id> |
Download a file |
gogcli drive upload <path> |
Upload a file |
gogcli drive share <id> --email "..." --role reader |
Share a file |
Contacts
| Command | Description |
|---|---|
gogcli contacts list |
List contacts |
gogcli contacts search "<name or email>" |
Search contacts |
gogcli contacts get <id> |
Get contact details |
Sheets
| Command | Description |
|---|---|
gogcli sheets read <id> |
Read spreadsheet data |
gogcli sheets update <id> --range "A1" --value "..." |
Update a cell |
gogcli sheets append <id> --range "A1" --values "[...]" |
Append rows |
Docs
| Command | Description |
|---|---|
gogcli docs read <id> |
Read a document |
gogcli docs create --title "..." |
Create a new document |
gogcli docs append <id> --text "..." |
Append text to a document |
Usage Examples
Check today's calendar:
gogcli calendar list --days 1
Search Gmail for an invoice:
gogcli gmail search "from:billing subject:invoice has:attachment"
Find a file in Drive:
gogcli drive search "Q1 report filetype:pdf"
Create a calendar event:
gogcli calendar create \
--title "Team standup" \
--start "2026-03-22T10:00:00" \
--end "2026-03-22T10:30:00" \
--attendees "alice@co.com,bob@co.com"
Look up a contact's email:
gogcli contacts search "Alice Chen"
Rules
- Always check if CLI is installed and authenticated:
gogcli auth status - If not installed, show
brew install steipete/tap/gogcliand stop - If not authenticated, show
gogcli auth loginand stop - NEVER expose OAuth tokens or credentials in responses
- When reading long emails or documents, truncate at 1000 chars and save full content to
workspace/gws-<type>-<id>.md - When listing calendar events, format as: date/time | title | location (if any)
- When sending emails, draft the content and confirm with the user before executing
- For Sheets operations, always confirm the spreadsheet ID and range before writing
- Keep responses concise: action confirmation in 1-2 lines