Skip to content

workspace-lite

Google Workspace MCP servers through per-service Apps Script proxies. Drive, Gmail, Calendar, Sheets, Slides, Docs, Tasks, and Forms in one agent-ready local toolkit.

Get started Review the architecture

218
MCP tools
8
Workspace services
20 ops
Per batch call
Apps Script
User-owned proxy runtime

What It Is

workspace-lite lets agents work with Google Workspace through local TypeScript MCP servers. The MCP servers validate tool input and send signed requests to small Apps Script web apps. Apps Script then calls Google APIs as the deploying user.

That split keeps the local agent experience simple while preserving the permission model users already understand in Google Workspace.

flowchart LR
  A[MCP client] --> B[Local TypeScript MCP server]
  B --> C[Apps Script web app proxy]
  C --> D[Google Workspace APIs]
  D --> C --> B --> A

Core Capabilities

  • Drive

    Files, folders, permissions, comments, replies, revisions, shared drives, changes, and batch file workflows.

    Drive guide

  • Gmail

    Search, read, labels, drafts, replies, forwarding, filters, vacation responder, and explicit send review.

    Gmail guide

  • Calendar

    Events, free/busy checks, calendar lists, settings, Meet links, RSVP, colors, moves, and batch scheduling.

    Calendar guide

  • Sheets

    Values, formulas, formatting, charts, sorting, validations, protections, row operations, and spreadsheet setup batches.

    Sheets guide

  • Slides & Docs

    Presentations, slide content, notes, images, tables, document structure, formatting, bookmarks, and named ranges.

    Slides guide Docs guide

  • Tasks & Forms

    Task lists, tasks, moves, completed-task cleanup, form settings, items, destinations, responses, and response deletion.

    Tasks guide Forms guide

Find Your Path

Role Goal Start here
User Install and run the first tool Installation -> Quickstart
Agent author Use tools safely in repeatable workflows Agent Skill Overview -> Agent Skill Workflows
Operator Deploy, refresh, and troubleshoot Apps Script proxies Setup Script -> Troubleshooting
Security reviewer Understand auth, input policy, risky actions, and response contracts Security Model -> Input Policies
Contributor Change code, docs, validators, or release automation Contributing -> Release Process

Install

git clone https://github.com/joe-broadhead/workspace-lite.git
cd workspace-lite
bash ./scripts/setup.sh --dry-run

git clone https://github.com/joe-broadhead/workspace-lite.git
cd workspace-lite
bash ./scripts/setup.sh

mkdir -p ~/.config/opencode/skills
ln -sf "$(pwd)/skills/google-workspace" ~/.config/opencode/skills/google-workspace
ln -sf "$(pwd)/skills/workspace-lite-installer" ~/.config/opencode/skills/workspace-lite-installer

The setup script creates or reuses one Apps Script project per service, pushes proxy code, guides the manual web app deployment step, bootstraps tokens, and prints MCP config.

Google review step

The first Apps Script web app deployment and OAuth scope review happen in Google's UI. Agents can help with local commands, but the user should review scopes and deployment settings directly.

Public Release Readiness

This repository includes CI, strict docs builds, release workflow automation, contributor guidance, security policy, changelog, and deterministic validators for manifests, response contracts, mutation safety, input policy, and registry architecture.

Public release checklist