google

Manage Gmail, Calendar, Drive, Sheets, Tasks, and Contacts via the gog CLI.

1|Updated May 6, 2026
One-click install
npx skills add https://github.com/surfingalien/FinSurfing --skill google-surfingalien
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google
Source: https://github.com/surfingalien/FinSurfing/tree/main/.claude/skills/google
Command: npx skills add https://github.com/surfingalien/FinSurfing --skill google-surfingalien

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Managing Google Workspace from the terminal requires memorizing dozens of API endpoints and query syntaxes. This Skill consolidates Gmail, Calendar, Drive, Sheets, Tasks, and Contacts operations into a single command-line workflow using the gog CLI, enabling fast inbox triage, meeting scheduling, and document management without leaving the terminal. ## Core Features & Use Cases - Gmail Triage & Search: Search, send, reply, and organize email using the full Gmail query operator syntax (from:, is:unread, newer_than:, has:attachment, and more). - Calendar Scheduling: Create events with Google Meet links, check free/busy availability across attendees, detect conflicts, set focus time and out-of-office status, and build recurring events with RRULE patterns. - Drive & Docs Management: Search files with Drive query syntax (MIME types, ownership, dates), upload/download, share files, and export Docs/Sheets/Slides to PDF, DOCX, or XLSX. - Tasks & Contacts: Manage task lists with due dates, and search or create contacts and directory entries. - Use Case: As an executive assistant, run a morning routine that checks unread VIP emails, reviews today's calendar, finds scheduling conflicts, and lists pending tasks — all with a few gog commands and jq for JSON parsing. ## Quick Start Ask the assistant to show all unread emails from your boss received in the last 7 days using the google skill.

Frequently Asked Questions about google

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search Gmail from the command line?

Use gog gmail search with Gmail query operators, for example gog gmail search "is:unread from:[email protected] newer_than:7d" --max=20. Operators cover sender, status, labels, dates, size, attachments, and categories, and can be combined with AND, OR, and NOT.

How do I schedule a Google Calendar meeting with a Meet link?

Run gog calendar create primary with --summary, --from, --to, --attendees, and the --with-meet flag to auto-generate a Google Meet link. Check attendee availability first with gog calendar freebusy to avoid conflicts.

What is required before using the gog CLI?

The gog CLI must be installed and authenticated. Verify with gog version and gog auth status, and add an account with gog auth add [email protected] --services=all. Multiple accounts are supported via the --account flag.

Can I search Google Drive files by content or type?

Yes, gog drive search supports fullText contains for content search, mimeType filters for file types like PDFs or Google Docs, ownership queries like 'me' in owners, and date filters such as modifiedTime. Combine conditions with and, or, and not.

How do I use gog output in scripts?

Add the --json flag to any gog command and pipe the result to jq for parsing, for example gog calendar events --today --json | jq '.[].id'. Use --plain for tab-separated output and --no-input to prevent prompts in automation.

Does gog support recurring calendar events?

Yes, pass an RRULE string with the --rrule flag when creating events, such as RRULE:FREQ=WEEKLY;BYDAY=MO,WE,FR;COUNT=10. Patterns support daily, weekly, monthly, and yearly frequencies with intervals, counts, and end dates.