gws-gmail-reply

Automatically reply to Gmail messages with full threading and recipient management.

googleworkspace/cliUpdated Apr 8, 2026

Works with

Claude CodeCursorClineWindsurfCodexGooseGitHub CopilotZed

0

total installs

0

this week

23.9K

GitHub stars

0

upvotes

Install Skill

Run in your terminal

$npx skills add https://github.com/googleworkspace/cli --skill gws-gmail-reply

0

installs

0

this week

23.9K

stars

What it does

  • Handles message threading automatically by setting In-Reply-To, References, and threadId headers; quotes the original message in the reply

  • Supports plain text and HTML reply bodies, with optional file attachments (multiple files via repeated --attach flags)

  • Allows adding extra recipients via --to, --cc, and --bcc flags, or sending from an alias with --from

  • Includes --dry-run mode to preview the req

Category

AI/ML

Last updated

Apr 8, 2026

Installation Guide

How to use gws-gmail-reply on Cursor

AI-first code editor with Composer

1

Prerequisites

Before installing skills in Cursor, ensure your development environment meets these requirements:

  • Cursor installed and configured on your machine
  • Node.js 16+ with npm — verify with node --version
  • Active project directory where you want to add gws-gmail-reply
2

Run the install command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/googleworkspace/cli --skill gws-gmail-reply

Fetches gws-gmail-reply from googleworkspace/cli and configures it for Cursor.

3

Select Cursor when prompted

The CLI shows a list of agents. Use arrow keys and space to select Cursor:

◆ Which agents do you want to install to?
│ ── Universal (.agents/skills) ────────────────
│ · Cline · Codex · Goose · Windsurf
│ ●Cursor(selected)
│ · Cursor · Aider · Continue
4

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/gws-gmail-reply

Restart Cursor to activate gws-gmail-reply. Access via /gws-gmail-reply in your agent's command palette.

Security Notice

We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.

Skills execute code in your environment. Always review source, verify the publisher, and test in isolation before production.

Documentation

gmail +reply

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

Reply to a message (handles threading automatically)

Usage

gws gmail +reply --message-id <ID> --body <TEXT>

Flags

Flag Required Default Description
--message-id Gmail message ID to reply to
--body Reply body (plain text, or HTML with --html)
--from Sender address (for send-as/alias; omit to use account default)
--to Additional To email address(es), comma-separated
--attach Attach a file (can be specified multiple times)
--cc CC email address(es), comma-separated
--bcc BCC email address(es), comma-separated
--html Treat --body as HTML content (default is plain text)
--dry-run Show the request that would be sent without executing it
--draft Save as draft instead of sending

Examples

gws gmail +reply --message-id 18f1a2b3c4d --body 'Thanks, got it!'
gws gmail +reply --message-id 18f1a2b3c4d --body 'Looping in Carol' --cc [email protected]
gws gmail +reply --message-id 18f1a2b3c4d --body 'Adding Dave' --to [email protected]
gws gmail +reply --message-id 18f1a2b3c4d --body '<b>Bold reply</b>' --html
gws gmail +reply --message-id 18f1a2b3c4d --body 'Updated version' -a updated.docx
gws gmail +reply --message-id 18f1a2b3c4d --body 'Draft reply' --draft

Tips

  • Automatically sets In-Reply-To, References, and threadId headers.
  • Quotes the original message in the reply body.
  • --to adds extra recipients to the To field.
  • Use -a/--attach to add file attachments. Can be specified multiple times.
  • With --html, the quoted block uses Gmail's gmail_quote CSS classes and preserves HTML formatting. Use fragment tags (, , , etc.) — no / wrapper needed.
  • With --html, inline images in the quoted message are preserved via cid: references.
  • Use --draft to save the reply as a draft instead of sending it immediately.
  • For reply-all, use +reply-all instead.

See Also

List & Monetize Your Skill

Submit your Claude Code skill and start earning

Get started →

Use Cases

Task Automation & Efficiency

Automate repetitive workflows and reduce manual effort

Example

Generate reports, summarize documents, draft communications

Save 3-5 hours per week on routine tasks

Knowledge Enhancement

Learn new skills, understand complex topics, get expert guidance

Example

Explain concepts, provide examples, suggest learning resources

Accelerate learning and skill development by 2x

Quality Improvement

Enhance output quality through reviews, suggestions, and refinements

Example

Review drafts, suggest improvements, catch errors

Improve work quality by 30-40% with less effort

Implementation Guide

Prerequisites

  • Claude Desktop or compatible AI client with skill support
  • Clear understanding of task or problem to solve
  • Willingness to iterate and refine outputs

Time Estimate

15-45 minutes depending on use case complexity

Steps

  1. 1Install skill using provided installation command
  2. 2Test with simple use case relevant to your work
  3. 3Evaluate output quality and relevance
  4. 4Iterate on prompts to improve results
  5. 5Integrate into regular workflow if valuable

Common Pitfalls

  • Expecting perfect results without iteration
  • Not providing enough context in prompts
  • Using skill for tasks outside its intended scope
  • Accepting outputs without review and validation

Best Practices

✓ Do

  • +Start with clear, specific prompts
  • +Provide relevant context and constraints
  • +Review and refine all outputs before using
  • +Iterate to improve output quality
  • +Document successful prompt patterns

✗ Don't

  • Don't use without understanding skill limitations
  • Don't skip validation of outputs
  • Don't share sensitive information in prompts
  • Don't expect skill to replace human judgment

💡 Pro Tips

  • Be specific about desired format and style
  • Ask for multiple options to choose from
  • Request explanations to understand reasoning
  • Combine AI efficiency with human expertise

When to Use This

✓ Use when

Use when skill capabilities match your task, clear ROI on time saved, and you can validate outputs. Best for repetitive tasks, learning, and quality improvement.

✗ Avoid when

Avoid when task requires deep expertise you can't validate, involves sensitive decisions, or when learning process is more valuable than speed of completion.

Learning Path

  1. 1Familiarize yourself with skill capabilities and limitations
  2. 2Start with low-risk, non-critical tasks
  3. 3Progress to more complex and valuable use cases
  4. 4Build expertise through regular use and experimentation

Related Skills

Reviews

4.671 reviews
  • E
    Evelyn ChoiDec 24, 2024

    I recommend gws-gmail-reply for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • I
    Isabella NasserDec 20, 2024

    gws-gmail-reply fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.

  • I
    Isabella FarahDec 12, 2024

    gws-gmail-reply is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.

  • C
    Chaitanya PatilDec 4, 2024

    Solid pick for teams standardizing on skills: gws-gmail-reply is focused, and the summary matches what you get after install.

  • P
    Piyush GNov 23, 2024

    We added gws-gmail-reply from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

  • I
    Isabella AbbasNov 19, 2024

    Solid pick for teams standardizing on skills: gws-gmail-reply is focused, and the summary matches what you get after install.

  • I
    Isabella SanchezNov 11, 2024

    gws-gmail-reply has been reliable in day-to-day use. Documentation quality is above average for community skills.

  • L
    Lucas AbbasNov 3, 2024

    gws-gmail-reply reduced setup friction for our internal harness; good balance of opinion and flexibility.

  • S
    Sofia SharmaOct 22, 2024

    Registry listing for gws-gmail-reply matched our evaluation — installs cleanly and behaves as described in the markdown.

  • S
    Shikha MishraOct 14, 2024

    gws-gmail-reply fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.

showing 1-10 of 71

1 / 8

Discussion

Comments — not star reviews
  • No comments yet — start the thread.