How-to · Productivity · By Google Workspace

How to use Google Workspace Events in your AI agent

Install and use the Google Workspace Events skill in Claude Code, Cursor, Codex, Gemini CLI, OpenCode, and Windsurf — with sample prompts.

What you'll get

This skill lets you subscribe to real-time notifications from Google Workspace apps like Gmail, Calendar, and Drive. You can set up alerts for events like new messages, calendar invites, or file changes, and receive them as they happen. It's useful for anyone who wants to automate responses to Workspace activity without constantly checking their apps.

Step 1 — Get the skill source URL

The Google Workspace Events skill lives at:

Step 2 — Add it to your AI agent

Copy one of these prompts and paste it into your AI tool. The agent will fetch and install the skill for you.

Claude Code

Add the agent skill from https://github.com/googleworkspace/cli/tree/main/skills/gws-events to my project.

Cursor

Install this agent skill: https://github.com/googleworkspace/cli/tree/main/skills/gws-events

Codex

Add this skill to .codex/skills/: https://github.com/googleworkspace/cli/tree/main/skills/gws-events

Gemini CLI

Add the skill at https://github.com/googleworkspace/cli/tree/main/skills/gws-events to my .gemini/skills/ directory.

OpenCode

Install this agent skill from https://github.com/googleworkspace/cli/tree/main/skills/gws-events

Windsurf

Add this skill: https://github.com/googleworkspace/cli/tree/main/skills/gws-events

Step 3 — Try these prompts

Once the skill is installed, ask your AI things like:

  • Know immediately when a specific email arrives or a file is updated
  • Automating workflows that depend on Google Workspace activity (e.g., logging meeting invites to Notion)
  • Monitor shared Drive folders for new uploads or changes

What this skill does

  • Subscribe to live event streams from Gmail, Calendar, Drive, and other Google Workspace apps
  • Receive instant notifications when emails arrive, calendar events are created, or files are edited
  • Renew or pause subscriptions to control when you receive alerts
  • List and manage all active event subscriptions across your Workspace
Made byGoogle Workspace
CategoryProductivity