# Gogcli

> Use this skill when the user wants to manage Gmail emails, Google Calendar events, Drive files, Contacts, or other Google Suite services via CLI.

- Skill: `javimosch/gogcli` (Agent Skill)
- Install (CLI): `npx skillmds@latest add javimosch/gogcli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/javimosch/gogcli/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: javimosch (https://skillmd.com/u/javimosch)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/javimosch/gogcli

---


# gogcli Plugin

Google Suite CLI for Gmail, Calendar, Drive, Tasks, Contacts, and more.

## Commands

### Authentication
- `gogcli auth status` — Show current auth state and services

### Gmail
- `gogcli gmail search` — Search threads/messages (use query like "newer_than:7d")
- `gogcli gmail send` — Send an email (requires --to, --subject)
- `gogcli gmail labels` — List all labels

### Calendar
- `gogcli calendar events` — List events (use --today for today, --calendar for specific)
- `gogcli calendar create` — Create event (requires --summary, --from, --to)

### Drive
- `gogcli drive list` — List files (optional --query filter)

### Tasks
- `gogcli tasks list` — List tasks

### Contacts
- `gogcli contacts search` — Search contacts by query

## Usage Examples
- "Search my Gmail for emails from last week"
- "Send an email to test@example.com with subject Hi"
- "List today's calendar events"
- "Create a meeting tomorrow at 2pm"
- "List files in Drive named report"

## Setup

```bash
brew install gogcli
gog auth credentials ~/Downloads/client_secret.json
gog auth add you@gmail.com
```

## Environment Variables
- `GOG_ACCOUNT` — Default account email
- `GOG_JSON` — Default JSON output
- `GOG_TIMEZONE` — Default timezone (e.g., America/New_York)