workspace-kit

A collection of production-ready OpenClaw skills for Google Workspace, powered by managed OAuth authentication via Maton.

Enable AI agents to seamlessly interact with Google Calendar, Google Tasks, Google Docs, Google Sheets, and Google Slides without manual OAuth token management.

---

📦 Included Skills

All skills are organized under the skills/ directory and conform to the standard OpenClaw specification:

Skill	Description	Primary CLI / Gateway
google-calendar	Manage calendars, events, agendas, colors, ACLs, and free/busy queries.	Native CLI (maton google-calendar)
google-tasks	Full CRUD operations on task lists and tasks, subtasks, and completion tracking.	Native CLI (maton google-tasks)
google-docs	Create, read document structure, append plain text, and batch-update rich formatting.	Native CLI (maton google-docs) + REST proxy
google-sheets	Create spreadsheets, read/write/append cell values (A1 notation), copy sheets, and format grids.	Native CLI (maton google-sheets) + REST proxy
google-slides	Inspect slide structures/elements and create/update presentations via atomic batch updates.	REST proxy (maton api /google-slides/...)

🔗 Related Skills

• Google Keep: tag-assistant/google-keep-skill — Google Keep integration skill for managing notes and lists.

---

🚀 Quick Start

1. Prerequisites

1. Obtain a Maton API Key:
   • Sign up or log in at maton.ai.
   • Go to maton.ai/settings and copy your API key.
2. Set the environment variable:

   export MATON_API_KEY="your_api_key_here"

2. Install Maton CLI (Optional)

Agents can decide whether to install the CLI based on the environment:

• macOS / Linux:

  curl -fsSL https://maton.ai/install.sh | bash

• Windows:

  irm https://maton.ai/install.ps1 | iex

• npm:

  npm install -g @maton/cli

3. Connect Google Workspace Apps

Authenticate your Google account for the respective services:

maton connection create google-calendar
maton connection create google-tasks
maton connection create google-docs
maton connection create google-sheets
maton connection create google-slides

Tip: Add -i / --interactive on headless servers to display the OAuth URL in the terminal.

---

⚡ Usage Examples

CLI

# Calendar: List today's agenda
maton google-calendar agenda --today

# Tasks: Create a new task
maton google-tasks task create -l <tasklistId> --title 'Finish design spec'

# Docs: Create a document and append content
maton google-docs document create --title 'Architecture RFC'
maton google-docs document write <documentId> --text 'Initial RFC proposal draft.'

# Sheets: Update values in a range
maton google-sheets values update <spreadsheetId> --range 'Sheet1!A1' --values 'Alice,100'

# Slides: Get presentation metadata
maton api '/google-slides/v1/presentations/<presentationId>'

Multi-Account / Multi-Connection Support

If you have multiple accounts connected (e.g. Personal and Work):

# Specify connection via CLI flag
maton google-docs document get <documentId> --connection <connection_id>

# Or via HTTP header
curl -H "Authorization: Bearer $MATON_API_KEY" \
     -H "Maton-Connection: <connection_id>" \
     https://api.maton.ai/google-docs/v1/documents/<documentId>

---

🛡️ Scope Distinction

To avoid agent confusion between cloud and local office documents, skills follow clear scope boundaries:

• Cloud Google Workspace: Handled by google-docs, google-sheets, google-slides (connecting to docs.google.com).
• Local Office Files: Handled by local file skills (e.g., docx for .docx, xlsx for .xlsx, pptx for .pptx).

---

📄 License

MIT © 2026 fize