google-workspace

Manage Gmail, Calendar, Drive, Contacts, Sheets, and Docs via a unified Python CLI.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/VYRE-Studios/Windows-Agentic-Framework --skill google-workspace-vyre-studios
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/VYRE-Studios/Windows-Agentic-Framework/tree/main/skills/productivity/google-workspace
Command: npx skills add https://github.com/VYRE-Studios/Windows-Agentic-Framework --skill google-workspace-vyre-studios

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires google-api-python-client, google-auth-oauthlib, google-auth-httplib2, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Provides a unified, agent-accessible interface to manage Gmail, Calendar, Drive, Contacts, Sheets, and Docs so users and automations can search email, manage events, and read or update files without manual API wiring.

Core Features & Use Cases

  • Unified API CLI: Single Python CLI that performs Gmail search/send/reply, Calendar event list/create/delete, Drive search, Contacts listing, Sheets read/update/append, and Docs retrieval.
  • OAuth2 with token management: Guided non-interactive OAuth setup, PKCE-supported auth flow, automatic refresh and revocation for long-running agents.
  • JSON-first outputs: All commands emit structured JSON for reliable parsing by agents and integrations.
  • Use Case: An agent can list unread messages, draft a reply for user approval, create calendar events with attendees, and update a spreadsheet row as part of a notification workflow.

Quick Start

Authorize the google-workspace skill using the setup script and then ask the agent to list your unread Gmail messages from the last 24 hours.

Frequently Asked Questions about google-workspace

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

FAQPage Schema
How do I automate Gmail search and Calendar event creation in a single workflow?

You can automate Gmail search and Calendar event creation together using a unified Python CLI that provides agent-accessible programmatic access to Google Workspace APIs, emitting structured JSON outputs for reliable parsing across both services.

Does Google Workspace automation require external binaries or manual API wiring?

Google Workspace automation with this approach does not require external binaries or manual API wiring, as it executes entirely via Google's Python client libraries and handles OAuth2 authentication including automatic token refresh internally.

What is the best way to manage OAuth2 token refresh for long-running Google API agents?

The best way to manage OAuth2 token refresh for long-running Google API agents is using a guided non-interactive OAuth setup with PKCE-supported auth flow, which handles automatic refresh and revocation autonomously.

Can I use a Python CLI to read and update Google Sheets and Docs without manual API wiring?

Yes, you can use a single Python CLI to read, update, and append spreadsheet rows or retrieve documents directly, applying Google's Python client libraries to interact with Sheets and Docs without manual API wiring.

How do I query Google Drive files and list Contacts as part of an agent-driven notification workflow?

You can query Google Drive files and list Contacts by executing CLI commands that leverage unified programmatic access to Google Workspace, formatting all responses as structured JSON for seamless integration into notification workflows.

Are there limitations when using Python client libraries for Google Calendar event management?

Google Calendar event management via Python client libraries is limited to list, create, and delete operations through the unified CLI, requiring completed OAuth2 authorization setup beforehand to ensure non-interactive execution for agents.