CtrlK
BlogDocsLog inGet started
Tessl Logo

gws-gmail

Read and manage Gmail across all connected Google accounts — search, send, reply, draft, archive, and label emails.

69

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Google Gmail Skill

Overview

This skill guides you in using the google_gmail MCP tool to manage email across all connected Google accounts.

Available Subcommands

SubcommandDescription
listList recent emails (defaults to INBOX). Use --query for Gmail search.
read <messageId>Read a full email thread by message ID.
sendCompose and send a new email.
reply <messageId>Reply to a specific message.
draftSave a draft without sending.
archive <messageId>Archive a message (remove from INBOX).
mark-read <messageId>Mark a message as read.
mark-unread <messageId>Mark a message as unread.
label <messageId>Apply or remove Gmail labels.

Account Routing

  • Reads (list, read): Omit account to query all accounts simultaneously.
  • Writes (send, reply, draft, archive, label, mark-read, mark-unread): You must specify account. If the user hasn't said which account, ask them first.
google_gmail(command: "list --query 'is:unread'")                    // all accounts
google_gmail(command: "send --to 'x@example.com' --subject 'Hi'", account: "Work")

Key Flags

FlagDescription
--query <q>Gmail search query (list only)
--max <n>Max results to return (default: 20)
--to <addr>Recipient email address
--cc <addr>CC recipient
--subject <text>Email subject
--body <text>Email body (plain text)
--label-ids <ids>Comma-separated label IDs to add/remove

Workflow: Reading and Replying

  1. List emails: google_gmail(command: "list --query 'is:unread'")
  2. Read a specific email: google_gmail(command: "read <messageId>")
  3. Reply: google_gmail(command: "reply <messageId> --body 'Thanks!'", account: "Work")

Error Handling

  • If no accounts are connected, direct user to Settings → Integrations.
  • If account is required but not specified, ask the user which account to use before proceeding.
Repository
accomplish-ai/coworker
Path

apps/desktop/bundled-skills/gws-gmail/SKILL.md

Commit

2cf74d0

Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.

Claim skill