Agent skill

Google Workspace

Gmail, Calendar, Drive, Sheets, Docs via Google API (SA / OAuth)

Apache-2.0Auto-check passedDocuments & Office

Install Google Workspace

skills CLI

$ npx skills add taracodlabs/aiden --skill google-workspace -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install taracodlabs/aiden google-workspace --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/taracodlabs/aiden.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/google-workspace .claude/skills/google-workspace && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "google-workspace" agent skill from https://github.com/taracodlabs/aiden/tree/main/skills/google-workspace into .claude/skills/google-workspace/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "google-workspace", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/taracodlabs/aiden/tree/main/skills/google-workspace

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add taracodlabs/aiden --skill google-workspace -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install taracodlabs/aiden google-workspace --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/taracodlabs/aiden.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/google-workspace .agents/skills/google-workspace && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "google-workspace" agent skill from https://github.com/taracodlabs/aiden/tree/main/skills/google-workspace into .agents/skills/google-workspace/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "google-workspace", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add taracodlabs/aiden --skill google-workspace -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install taracodlabs/aiden google-workspace --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/taracodlabs/aiden.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/google-workspace .cursor/skills/google-workspace && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "google-workspace" agent skill from https://github.com/taracodlabs/aiden/tree/main/skills/google-workspace into .cursor/skills/google-workspace/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "google-workspace", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/taracodlabs/aiden.git --path skills/google-workspace

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add taracodlabs/aiden --skill google-workspace -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install taracodlabs/aiden google-workspace --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/taracodlabs/aiden.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/google-workspace .gemini/skills/google-workspace && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "google-workspace" agent skill from https://github.com/taracodlabs/aiden/tree/main/skills/google-workspace into .gemini/skills/google-workspace/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "google-workspace", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install taracodlabs/aiden google-workspace

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add taracodlabs/aiden --skill google-workspace -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/taracodlabs/aiden.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/google-workspace .github/skills/google-workspace && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "google-workspace" agent skill from https://github.com/taracodlabs/aiden/tree/main/skills/google-workspace into .github/skills/google-workspace/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "google-workspace", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add taracodlabs/aiden --skill google-workspace -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install taracodlabs/aiden google-workspace --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/taracodlabs/aiden.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/google-workspace .opencode/skills/google-workspace && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "google-workspace" agent skill from https://github.com/taracodlabs/aiden/tree/main/skills/google-workspace into .opencode/skills/google-workspace/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "google-workspace", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: google-workspace
GitHub stars: 851
Token cost: ~1.1k tokens
SKILL.md length: 259 words
Files: 2
Skills in repo: 63
Repo updated: Sep 13, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

Gmail, Calendar, Drive, Sheets, Docs via Google API (SA / OAuth)

Works in 7 steps: Authenticate — OAuth token (quickest) → List recent Gmail messages → List today's Calendar events → …
Tasks that involve Cloud office suites
SKILL.md covers When to Use, How to Use, Examples and Cautions
Calls gcloud; reaches gmail.googleapis.com and googleapis.com; needs GOOGLE_APPLICATION_CREDENTIALS

What it does

Google Workspace is an agent skill from taracodlabs/aiden. Gmail, Calendar, Drive, Sheets, Docs via Google API (SA / OAuth)

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `skill.json`).

It sits in Documents & Office, covering Cloud office suites, Email management and OAuth and OpenID Connect. It works with Google Workspace, Gmail, Google Sheets and Google Cloud. The repository describes itself as: Aiden — an autonomous AI agent and work engine built solo. It can operate your browser, terminal, files, apps, APIs, skills and tools, remember context, recover from failures… The licence is Apache-2.0.

When your agent uses it

Tasks that involve Cloud office suites
Tasks that involve Email management
Tasks that involve OAuth and OpenID Connect

Example prompts

“/google-workspace”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

Authenticate — OAuth token (quickest)
List recent Gmail messages
List today's Calendar events
Read a Google Sheet
Write to a Google Sheet
List Google Drive files
Read a Google Doc

What it can do on your machine

Read from SKILL.md and the folder at commit 3704204. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- gcloud
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- gmail.googleapis.com
- googleapis.com
- sheets.googleapis.com
- docs.googleapis.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- GOOGLE_APPLICATION_CREDENTIALS
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Google Workspace loads about 1.1k tokens when it runs. Until then it costs about 20 tokens; SKILL.md has 259 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~20
When it runs · the whole SKILL.md, loaded when a task matches: ~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from taracodlabs/aiden at commit 3704204, republished under its Apache-2.0 licence (© taracodlabs). 259 words, ~1,094 tokens.

Download SKILL.mdSave it as .claude/skills/google-workspace/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.

name: 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):

powershell

# 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

powershell

$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

powershell

$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

powershell

$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

powershell

$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

powershell

$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

powershell

$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-token as 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 nextPageToken for pagination
Sending emails requires the gmail.send scope — confirm scope during OAuth setup

Files

SKILL.md and 1 other file in skills/google-workspace of taracodlabs/aiden.

SKILL.md
skill.json

Open the folder on GitHubat commit 3704204

Compare with similar skills

Google Workspace next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Google Workspace compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Google Workspace this skilltaracodlabs/aiden	851	—	~1.1k	Automated safety check: Pass	Apache-2.0	25 days ago
Managing Google Workspacetaylorwilsdon/google_workspace_mcp	3.3k	—	~2.9k	Automated safety check: Pass	MIT	yesterday
Google Workspaceespennilsen/pi	122	—	~3.4k	Automated safety check: Pass	MIT	17 days ago
GCP Workspace Pivotwgpsec/AboutSecurity	1.8k	—	~2.9k	Automated safety check: Pass	None	5 days ago
Google WorkspaceTommy-yw/RunbookHermes	546	2 repos	~2.7k	Automated safety check: Pass	MIT	4 mo ago
Community Google WorkspaceArgentAIOS/argentos-core	126	—	~2.8k	Automated safety check: Pass	MIT	3 mo ago

Similar skills

Managing Google Workspace
taylorwilsdon/google_workspace_mcp
Manages Google Workspace operations across 12 services (Gmail, Drive, Calendar, Docs, Sheets, Slides, Forms, Tasks, Contacts, Chat, Apps Script, Custom Search).
3.3k GitHub stars~2.9k tokensUpdated yesterday
Documents & OfficeAuto-check passed
Google Workspace
espennilsen/pi
Manage Google Workspace via the gws CLI — Drive, Gmail, Sheets, Docs, Slides, People, Chat, Meet, Forms, and cross-service workflows.
122 GitHub stars~3.4k tokensUpdated 17 days ago
Documents & OfficeAuto-check passed
GCP Workspace Pivot
wgpsec/AboutSecurity
GCP 到 Google Workspace 的穿越攻击方法论。当已获取 GCP Service Account 或 Project 权限并发现目标组织使用 Google Workspace、需要从云平台穿越到企业邮件/文档/管理控制台、或发现 Domain-Wide Delegation 配置时使用。覆盖 Domain-Wide Delegation 滥用、OAuth…
1.8k GitHub stars~2.9k tokensUpdated 5 days ago
Backend & APIsAuto-check passed
Google Workspace
Tommy-yw/RunbookHermes
Gmail, Calendar, Drive, Contacts, Sheets, and Docs integration for Hermes.
546 GitHub starsUsed in 2 repos~2.7k tokens
Documents & OfficeAuto-check passed
Community Google Workspace
ArgentAIOS/argentos-core
Gmail, Calendar, Drive, Contacts, Sheets, and Docs integration for community skills.
126 GitHub stars~2.8k tokensUpdated 3 mo ago
Documents & OfficeAuto-check passed
Google Workspace
ericrisco/rsc-harness
A skill your agent uses when server-side code reads or writes Gmail, Drive, Calendar, or Sheets with a GCP service account and no human in the OAuth loop: picking the auth mode (app-owned vs…
167 GitHub stars~3.2k tokensUpdated yesterday
Backend & APIsAuto-check passed

Questions about Google Workspace

What does Google Workspace do?

Gmail, Calendar, Drive, Sheets, Docs via Google API (SA / OAuth). Google Workspace is an agent skill from taracodlabs/aiden.

When should I use Google Workspace?

Google Workspace fits situations like: tasks that involve Cloud office suites; tasks that involve Email management; tasks that involve OAuth and OpenID Connect.

How do I install Google Workspace in Claude Code?

Run `npx skills add taracodlabs/aiden --skill google-workspace -a claude-code`. Or copy the skill folder (skills/google-workspace in taracodlabs/aiden) into .claude/skills/google-workspace in your project. Claude Code loads it when a task matches its description.

How do I install Google Workspace in Codex?

Run `npx skills add taracodlabs/aiden --skill google-workspace -a codex`. Or copy the skill folder (skills/google-workspace in taracodlabs/aiden) into .agents/skills/google-workspace in your project. Codex loads it when a task matches its description.

Can I use Google Workspace in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add taracodlabs/aiden --skill google-workspace -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/google-workspace, .gemini/skills/google-workspace, .github/skills/google-workspace and .opencode/skills/google-workspace in your project.

What does Google Workspace need to run?

Going by SKILL.md and its folder, Google Workspace needs the command-line tools its instructions call (gcloud) and credentials named GOOGLE_APPLICATION_CREDENTIALS.

Does Google Workspace access the network?

SKILL.md names 4 domains. In commands or code: gmail.googleapis.com, googleapis.com, sheets.googleapis.com and docs.googleapis.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Google Workspace safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Google Workspace use?

Google Workspace is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Google Workspace use?

About 1.1k tokens (SKILL.md is roughly 4.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Google Workspace?

Skills that share tags, products or a category with Google Workspace: Managing Google Workspace (taylorwilsdon/google_workspace_mcp, 3.3k stars), Google Workspace (espennilsen/pi, 122 stars), GCP Workspace Pivot (wgpsec/AboutSecurity, 1.8k stars) and Google Workspace (Tommy-yw/RunbookHermes, 546 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Google Workspace?

taracodlabs (a GitHub organization) maintains it in taracodlabs/aiden, which has 851 GitHub stars. The repository holds 63 skills in this directory. The repository was last updated on September 13, 2026.

Source: taracodlabs/aiden on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Google Workspace

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Google Workspace Integration

When to Use

How to Use

1. Authenticate — OAuth token (quickest)

2. List recent Gmail messages

3. List today's Calendar events

4. Read a Google Sheet

5. Write to a Google Sheet

6. List Google Drive files

7. Read a Google Doc

Examples

Cautions

Files

Compare with similar skills

Similar skills

More from taracodlabs/aiden

Related

Questions about Google Workspace