google-workspace

Calls Gmail, Calendar, Drive, Sheets, Docs, and Tasks APIs via a curl-based shell script.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills --skill google-workspace-lgj-jonathan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills/tree/main/google-workspace
Command: npx skills add https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills --skill google-workspace-lgj-jonathan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq.

What problem does it solve? Accessing Google Workspace APIs normally requires OAuth setup, token management, and client libraries. This Skill provides a pre-authenticated shell script that calls Gmail, Calendar, Drive, Sheets, Docs, Tasks, and Slides APIs directly, with automatic token refresh handled for you. ## Core Features & Use Cases - Gmail Operations: List, read, send, trash, and modify messages and labels using standard Gmail search syntax. - Calendar & Tasks Management: Create, list, update, and delete calendar events and task list items with ISO 8601 dates. - Drive, Sheets & Docs Access: Search and export Drive files, read and write spreadsheet ranges, and create or edit Docs documents. - Use Case: Ask the assistant to check your last five unread emails, summarize them, and then create a follow-up calendar event — all executed through pre-authenticated API calls without any setup. ## Quick Start Ask the assistant to list your five most recent Gmail messages or show your upcoming calendar events for this week.

Frequently Asked Questions about google-workspace

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

FAQPage Schema
How do I send an email with the Gmail API from a shell script?

Build a raw RFC 822 message, base64url-encode it, then call gmail.users.messages send with userId set to "me" and the encoded string in the raw field. The gws.sh script handles OAuth tokens automatically.

How do I list Google Calendar events for a specific date range?

Call calendar.events list with calendarId set to "primary", plus timeMin, orderBy set to startTime, and singleEvents set to true. Dates must be in ISO 8601 format.

Do I need to set up OAuth credentials to use the Google Workspace APIs?

No. Credentials for the account are pre-mounted at /home/node/.config/gws/credentials.json, and token refresh is automatic. The script caches access tokens and retries once on a 401 response.

Can I read and update Google Sheets values from the command line?

Yes. Use sheets.spreadsheets.values get to read a range like Sheet1!A1:D10, and update or append with valueInputOption set to USER_ENTERED and a JSON values array as the request body.

Why does the native gws binary fail inside Linux containers?

The native gws binary fails on node:22-slim images due to a GLIBC mismatch. The gws.sh script works around this by calling Google APIs directly with curl, and only defers to the binary when it exists on PATH.