How-to · Productivity · By Google Workspace

How to use Gmail Manager in your AI agent

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

What you'll get

This skill lets you manage your Gmail inbox through plain English requests. You can send emails, read messages, reply or forward conversations, and triage your unread mail — all without writing a single line of code. Perfect for founders, operators, and anyone who wants AI to handle email grunt work.

Step 1 — Get the skill source URL

The Gmail Manager 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-gmail to my project.

Cursor

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

Codex

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

Gemini CLI

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

OpenCode

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

Windsurf

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

Step 3 — Try these prompts

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

  • Send bulk emails or templated messages quickly
  • You want a daily summary of unread messages without opening Gmail
  • Replying to dozens of emails and want AI to draft responses
  • Forward important threads to your team automatically

What this skill does

  • Sends new emails with attachments and formatting
  • Reads and extracts content from messages in your inbox
  • Replies to emails and handles threading automatically
  • Forwards messages to new recipients
  • Shows unread inbox summaries with sender, subject, and date
  • Watches for new emails and streams them as they arrive
Made byGoogle Workspace
CategoryProductivity