gws-gmail
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
| Subcommand | Description |
|---|---|
list |
List recent emails (defaults to INBOX). Use --query for Gmail search. |
read <messageId> |
Read a full email thread by message ID. |
send |
Compose and send a new email. |
reply <messageId> |
Reply to a specific message. |
draft |
Save 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
accountto 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
| Flag | Description |
|---|---|
--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
- List emails:
google_gmail(command: "list --query 'is:unread'") - Read a specific email:
google_gmail(command: "read <messageId>") - Reply:
google_gmail(command: "reply <messageId> --body 'Thanks!'", account: "Work")
Error Handling
- If no accounts are connected, direct user to Settings → Integrations.
- If
accountis required but not specified, ask the user which account to use before proceeding.
More from accomplish-ai/accomplish
google-sheets
Automate Google Sheets interactions through browser automation - create spreadsheets, enter data, apply formulas, and format cells.
16safe-file-deletion
Enforces explicit user permission before any file deletion. Activates when you're about to use rm, unlink, fs.rm, or any operation that removes files from disk. MUST be followed for all delete operations.
16code-review
Review code for bugs, security issues, performance problems, and best practices. Provide actionable feedback.
15ask-user-question
Ask users questions via the UI. Use when you need clarification, user preferences, or confirmation before proceeding. The user CANNOT see CLI output - this tool is the ONLY way to communicate with them.
15google-workspace
Interact with Google Workspace - create documents, spreadsheets, send emails via Gmail, and manage Google Drive files.
11web-research
Research topics on the web, gather information from multiple sources, and summarize findings.
7