google-workspace
Gmail, Calendar, Drive, Sheets, Docs via Google API (SA / OAuth)
Install / Use
npx skills add taracodlabs/aiden --skill google-workspaceInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
CommunicationSupported Platforms
Our assessment of google-workspace
google-workspace scores 85/100 on our quality scale, 300th of 394 Communication skills we index.
Its SKILL.md is 4.3 KB long, well organised into 14 sections with 7 code examples: a solid amount of guidance for an agent.
It has 843 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so google-workspace is actively maintained.
- Our last check on 2026-11-05 found the source still online.
- It is released under AGPL-3.0, a copyleft license: you can use it, but modified versions you distribute must carry the same license.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit ā read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-06. Automated pattern scan on 2026-10-06. It catches known dangerous patterns, not every risk ā read a skill before letting an agent act on it.
google-workspace compared with similar skills
All 4 of these similar skills score higher than google-workspace; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| google-workspace (this skill)by taracodlabs | 85 | 843 | 2mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.7k | 9d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.9k | today | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.9k | today | MCP Server |
| crawl4aiby unclecode | 100 | 87.5k | today | MCP Server |
Frequently asked questions
- How do I install google-workspace?
- Run
npx skills add taracodlabs/aiden --skill google-workspace. The install tabs above show the steps for each supported agent. - Which AI agents does google-workspace work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is google-workspace safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is AGPL-3.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is google-workspace still maintained?
- The repository was last updated about 2 months ago, so google-workspace is actively maintained.
Skill content
View source on GitHubname: google-workspace description: Gmail, Calendar, Drive, Sheets, Docs via Google API (SA / OAuth) category: productivity version: 1.0.0 origin: aiden license: Apache-2.0 tags: google, gmail, calendar, drive, sheets, docs, workspace, api, oauth, email
Google Workspace Integration
Access Gmail, Google Calendar, Drive, Sheets, and Docs through the Google REST APIs. Requires either a service account JSON key (GOOGLE_APPLICATION_CREDENTIALS) or an OAuth2 access token.
When to Use
- User wants to read or send Gmail messages
- User wants to list or create Google Calendar events
- User wants to read/write a Google Sheet
- User wants to list Google Drive files
- User wants to read or update a Google Doc
How to Use
1. Authenticate ā OAuth token (quickest)
Get a short-lived access token via gcloud CLI (requires Google Cloud SDK installed):
# One-time login (opens browser)
gcloud auth login
# Get token for API calls
$token = (gcloud auth print-access-token)
$headers = @{ "Authorization" = "Bearer $token" }
For service accounts, set GOOGLE_APPLICATION_CREDENTIALS to the JSON key path and use gcloud auth application-default print-access-token.
2. List recent Gmail messages
$resp = Invoke-RestMethod -Uri "https://gmail.googleapis.com/gmail/v1/users/me/messages?maxResults=10" -Headers $headers
$resp.messages | ForEach-Object {
$msg = Invoke-RestMethod -Uri "https://gmail.googleapis.com/gmail/v1/users/me/messages/$($_.id)?format=metadata&metadataHeaders=Subject,From,Date" -Headers $headers
$msg.payload.headers | Where-Object { $_.name -in @("Subject","From","Date") } | Select-Object name,value
}
3. List today's Calendar events
$now = [System.DateTime]::UtcNow.ToString("yyyy-MM-ddTHH:mm:ssZ")
$end = [System.DateTime]::UtcNow.AddDays(1).ToString("yyyy-MM-ddTHH:mm:ssZ")
$resp = Invoke-RestMethod -Uri "https://www.googleapis.com/calendar/v3/calendars/primary/events?timeMin=$now&timeMax=$end&singleEvents=true&orderBy=startTime" -Headers $headers
$resp.items | Select-Object summary, @{N="start";E={$_.start.dateTime}}
4. Read a Google Sheet
$spreadsheetId = "your-sheet-id" # from URL: /spreadsheets/d/<id>/
$range = "Sheet1!A1:E20"
$resp = Invoke-RestMethod -Uri "https://sheets.googleapis.com/v4/spreadsheets/$spreadsheetId/values/$range" -Headers $headers
$resp.values | ForEach-Object { $_ -join "`t" }
5. Write to a Google Sheet
$spreadsheetId = "your-sheet-id"
$range = "Sheet1!A1"
$writeHeaders = $headers.Clone(); $writeHeaders["Content-Type"] = "application/json"
$payload = @{ values = @(@("Name","Score"),@("Alice","95"),@("Bob","87")) } | ConvertTo-Json
Invoke-RestMethod -Uri "https://sheets.googleapis.com/v4/spreadsheets/$spreadsheetId/values/$range`?valueInputOption=RAW" -Method Put -Headers $writeHeaders -Body $payload
6. List Google Drive files
$resp = Invoke-RestMethod -Uri "https://www.googleapis.com/drive/v3/files?pageSize=20&fields=files(id,name,mimeType,modifiedTime)" -Headers $headers
$resp.files | Select-Object name, mimeType, modifiedTime | Format-Table -AutoSize
7. Read a Google Doc
$docId = "your-doc-id" # from URL: /document/d/<id>/
$resp = Invoke-RestMethod -Uri "https://docs.googleapis.com/v1/documents/$docId" -Headers $headers
$resp.body.content | Where-Object { $_.paragraph } |
ForEach-Object { $_.paragraph.elements.textRun.content } | Where-Object { $_ } | Out-String
Examples
"Show me my unread Gmail emails from today"
ā Use step 2 with query parameter q=is:unread after:2026/04/17.
"What meetings do I have tomorrow?"
ā Use step 3 with tomorrow's date range for timeMin/timeMax.
"Read the sales data from my Google Sheet" ā Use step 4 with the sheet ID from the URL and the relevant range.
Cautions
- OAuth tokens expire after 1 hour ā refresh with
gcloud auth print-access-tokenas needed - Service account must be granted Workspace domain-wide delegation to impersonate users
- Google Sheets API ranges use A1 notation ā specify exact range to avoid reading entire sheet
- Drive API returns a maximum of 1000 files per page; use
nextPageTokenfor pagination - Sending emails requires the
gmail.sendscope ā confirm scope during OAuth setup
Related Skills
Agent-Reach
112.7kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu ā one CLI, zero API fees.
headroom
79.9kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Scrapling
103.9kš·ļø The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
crawl4ai
87.5kOfficial Crawl4AI Cloud: a hosted web scraping, extraction, and search API for AI agents. Free API key, 1,000 credits a month, no card. Fully open source: this repo is the Apache-2.0 crawler that powers it, and you can self-host it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit ā see the Safety scan above for what the skill file itself contains.
