Gmail agent skills for Claude Code, Cursor and RevampKey

5 ready-made playbooks that teach an AI agent how to do real Gmail work: which tools to call, what to check first, and when to stop and ask you.

Download RevampKey, free I have it: connect Gmail

Connect Gmail once and all 5 skills install themselves and stay up to date. Mac, Windows and Linux.

All 5 Gmail skills

Each skill is one job. You ask in plain words and the agent loads the skill that matches, then follows its steps.

Start hereAsks before writing24 Gmail tools

Use Gmail with AI, safely

Sets the rules for working in your Gmail: confirm the account, keep searches narrow, and ask before any send, trash, spam, label or filter change.

Use it when

You have just connected Gmail and want the assistant to work in it carefully
You want to know what the assistant will and will not change without asking
A Gmail request is starting and you want it scoped to the right account

Tools it uses

search_threads
get_thread
label_thread
unlabel_thread
trash_thread
mark_thread_spam
apply_sensitive_thread_label
get_message
label_message
unlabel_message
trash_message
mark_message_spam
unmark_message_spam
apply_sensitive_message_label
list_labels
create_label
delete_label
list_filters
create_filter
list_drafts
create_draft
reply
forward
send_message

Example

Search my work Gmail for threads from billing@vendor.example in the last 60 days and summarise what they are about.

You're signed in as jamie@northwind.example. I found 7 threads from billing@vendor.example in the last 60 days: 5 are monthly invoices, 2 are payment-failure notices. I have only read them and changed nothing. Want me to label the two failures for follow-up?

Use in RevampKeyRead the full skill →

Asks before writing5 Gmail tools

Draft Gmail replies with AI

Reads the full thread, matches its tone and open questions, and saves a reply as a Gmail draft. Nothing is sent until you approve it.

Use it when

You need to answer a long email thread without re-reading all of it.
You want a polite decline or a timeline update drafted in your own voice.
You have a new email to write but only the recipient and the point to make.

Tools it uses

get_thread
create_draft
list_drafts
send_message
reply

Example

Draft a reply to Priya's email about the Q3 budget and save it as a draft. I can't confirm the new date yet.

I've saved a draft reply to Priya in the Q3 budget thread. It answers her question on headcount and leaves the revised launch date as [DATE] for you to fill in. I did not send it. Before you send: fill in the date, and confirm that Priya is the only recipient, since the thread was copied to two others.

Use in RevampKeyRead the full skill →

Read-only2 Gmail tools

Triage your Gmail inbox with AI

Sorts your unread or recent Gmail into act now, reply later, file away and ignore, and proposes labels or trash for your approval. It never changes anything without asking first.

Use it when

You come back from leave and need to see what matters first
Your inbox has grown past what you can scan in a morning
You want to know which threads are waiting on your reply today

Tools it uses

search_threads
get_thread

Example

Triage my unread email from the last two days and tell me what needs an answer today.

You have 23 unread threads from the last two days. Three are act now: a contract signature request from Dana due Thursday, a failed payment notice from your hosting provider, and a question from Priya about the launch date. Nine are reply later, and eleven are file away or ignore. I propose labelling the eleven receipts and confirmations as Finance/Receipts. Approve that and I will apply it.

Use in RevampKeyRead the full skill →

Asks before writing6 Gmail tools

Clean up Gmail labels and filters with AI

Audits your existing Gmail labels and filters for duplicates, dead labels and conflicting rules, then proposes a tidier scheme. It changes nothing until you approve each step.

Use it when

Your Gmail has grown dozens of labels and you cannot remember which ones matter
A filter seems to be hiding mail and you want to find out which one
You want to merge two labels that mean the same thing without losing messages

Tools it uses

list_labels
list_filters
list_drafts
create_label
delete_label
create_filter

Example

Audit my Gmail labels and filters and suggest what to merge or delete. Don't change anything until I say so.

I found 31 user labels and 14 filters on your account. Two labels, Client and Clients, cover the same mail, and one filter skips the inbox for a sender whose address has changed, so new mail from them isn't matching it. I've proposed five steps ordered by risk, starting with that filter fix. Tell me which to apply.

Use in RevampKeyRead the full skill →

Asks before writing5 Gmail tools

Review spam-like and sensitive Gmail threads

Checks threads that look like phishing, junk or sensitive mail, separates real threats from legitimate messages, and proposes spam or sensitive-label actions. It asks before changing anything.

Use it when

A suspicious email got through and you want to know if it is phishing
You want to check what Gmail flagged as spam before you trust the filter
Your bank or tax notices are being treated as junk and need protecting

Tools it uses

search_threads
get_thread
mark_thread_spam
apply_sensitive_thread_label
trash_thread

Example

Check the 12 threads in my Suspicious label and tell me which are phishing, which are just unwanted, and which are legitimate bills I should keep.

I reviewed 12 threads from your Suspicious label. Three look like phishing: two use lookalike domains for your bank and one asks you to confirm a payment through a login link. Five are unwanted marketing with no request. Four are legitimate but sensitive, including a utility bill and a tax notice. I propose marking the three phishing threads as spam and trashing them, and applying the sensitive label to the four. Nothing has changed yet; tell me which groups to apply.

Use in RevampKeyRead the full skill →

Get all 5 without copying a file

RevampKey adds the skills when you connect Gmail, updates them for you and removes them when you disconnect.

Download RevampKey

How Gmail skills work

Connect Gmail
The Gmail MCP server gives the agent its tools.
Ask in plain words
“Draft a reply to Priya's email about the Q3 budget and save it as a draft. I can't confirm the new date yet.” Each SKILL.md says when it applies, so only the one that fits is loaded.
Approve any change
The agent calls the tools in order, checks its work, and shows you any change before it makes it.

How to install Gmail skills

In RevampKey the skills install themselves when you connect Gmail. In other tools each skill is one folder with a SKILL.md file, and you also need the Gmail MCP server connected there.

About 1 minute · nothing to copy

Download RevampKey for Mac, Windows or Linux and sign in.
Open Connectors and connect Gmail. All 5 skills come with it and stay up to date; they go away when you remove the connector.
Ask in plain language, for example “Draft a reply to Priya's email about the Q3 budget and save it as a draft. I can't confirm the new date yet.”
Download RevampKeyConnect Gmail · 1 click
Get RevampKey to connect Gmail
RevampKey is a free desktop app for Mac, Windows and Linux. Install it, sign in, and Gmail is one click away with its skills already attached.
Download RevampKey
Not now? Use the skills in your current tool
for s in essentials draft-reply inbox-triage label-and-filter-cleanup thread-spam-and-sensitive-review; do curl -fsSL --create-dirs -o .claude/skills/gmail-$s/SKILL.md https://revampkey.com/marketplace/gmail/skills/$s/SKILL.md done
Other tools

Into this project’s .claude/skills folder

Connect the Gmail MCP server in Claude Code.

Run this in your project folder to add all 5 skills:

for s in essentials draft-reply inbox-triage label-and-filter-cleanup thread-spam-and-sensitive-review; do
  curl -fsSL --create-dirs -o .claude/skills/gmail-$s/SKILL.md https://revampkey.com/marketplace/gmail/skills/$s/SKILL.md
done

Ask in plain language, for example “Draft a reply to Priya's email about the Q3 budget and save it as a draft. I can't confirm the new date yet.”

Into the shared .agents/skills folder

Connect the Gmail MCP server in Cursor.

Run this in your project folder to add all 5 skills:

for s in essentials draft-reply inbox-triage label-and-filter-cleanup thread-spam-and-sensitive-review; do
  curl -fsSL --create-dirs -o .agents/skills/gmail-$s/SKILL.md https://revampkey.com/marketplace/gmail/skills/$s/SKILL.md
done

Ask in plain language, for example “Draft a reply to Priya's email about the Q3 budget and save it as a draft. I can't confirm the new date yet.”

Into the shared .agents/skills folder

Connect the Gmail MCP server in Codex.

Run this in your project folder to add all 5 skills:

for s in essentials draft-reply inbox-triage label-and-filter-cleanup thread-spam-and-sensitive-review; do
  curl -fsSL --create-dirs -o .agents/skills/gmail-$s/SKILL.md https://revampkey.com/marketplace/gmail/skills/$s/SKILL.md
done

Ask in plain language, for example “Draft a reply to Priya's email about the Q3 budget and save it as a draft. I can't confirm the new date yet.”

Into the shared .agents/skills folder

Connect the Gmail MCP server in VS Code.

Run this in your project folder to add all 5 skills:

for s in essentials draft-reply inbox-triage label-and-filter-cleanup thread-spam-and-sensitive-review; do
  curl -fsSL --create-dirs -o .agents/skills/gmail-$s/SKILL.md https://revampkey.com/marketplace/gmail/skills/$s/SKILL.md
done

Ask in plain language, for example “Draft a reply to Priya's email about the Q3 budget and save it as a draft. I can't confirm the new date yet.”

RevampKey or copy the files?

In RevampKey

One click when you connect Gmail
Updated for you when a skill improves
Removed when you disconnect
The MCP server is set up for you
800+ other connectors, same way

Download free

Copy into your project

One command per project
Run it again to get updates
You connect the Gmail MCP server yourself
Works in Claude Code, Cursor, Codex and VS Code

See the command

Gmail skills FAQ

What is a Gmail agent skill?

A SKILL.md file: a short playbook an AI agent loads when your request matches it. Each Gmail skill describes one job, which Gmail tools to use in which order, what to check first and when to stop and ask you.

Do the Gmail skills change anything on their own?

1 of the 5 only read. The others tell the agent to show you the change and wait for a yes before it creates, edits or deletes anything in Gmail.

Which tools can use these skills?

Any agent that reads the open Agent Skills format: Claude Code, Cursor, Codex, VS Code with Copilot and RevampKey. In RevampKey they are attached when you connect Gmail; elsewhere you copy the folders into your project or skills directory.

Do I need the Gmail MCP server too?

Yes. The skills tell the agent how to do the work; the Gmail MCP server gives it the tools to do it. The Gmail MCP setup guide covers every client.

Gmail MCP server setup · This page as Markdown

Put Gmail’s best workflows in your agent

Download RevampKey, connect Gmail and ask your first question in about a minute.

Download RevampKey Connect Gmail · 1 click

All 5 Gmail skills

Use Gmail with AI, safely

Use it when

Tools it uses

Draft Gmail replies with AI

Use it when

Tools it uses

Triage your Gmail inbox with AI

Use it when

Tools it uses

Clean up Gmail labels and filters with AI

Use it when

Tools it uses

Review spam-like and sensitive Gmail threads

Use it when

Tools it uses

Get all 5 without copying a file

How Gmail skills work

How to install Gmail skills

RevampKey or copy the files?

In RevampKey

Copy into your project

Gmail skills FAQ

Put Gmail’s best workflows in your agent

Skills for related tools