mcpField
G
gws-gmail

gws-gmail

github.com/streakycProductivity01.4k installsUpdated 12w ago
Repository

About gws-gmail

A command-line skill for working with Gmail through `gws`. It combines email helper commands with access to Gmail API resources and method-schema inspection.

Key features

  1. 01Send, read, reply to, and forward email
  2. 02Summarize unread inbox messages
  3. 03Stream new email as NDJSON
  4. 04Access Gmail messages, threads, labels, and settings
  5. 05Inspect API methods and parameters

Use cases

  1. 01Review unread messages at a glance
  2. 02Handle threaded replies or forwards
  3. 03Monitor incoming mail as a stream
  4. 04Discover parameters before invoking a Gmail API method

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/streakyc/googleworkspacecli --skill gws-gmail

After installing, type/gws-gmailin Claude Code to confirm it loaded.

Details

From the project README

gmail (v1)

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

gws gmail <resource> <method> [flags]

Helper Commands

CommandDescription
+sendSend an email
+triageShow unread inbox summary (sender, subject, date)
+replyReply to a message (handles threading automatically)
+reply-allReply-all to a message (handles threading automatically)
+forwardForward a message to new recipients
+readRead a message and extract its body or headers
+watchWatch for new emails and stream them as NDJSON

API Resources

users
  • getProfile — Gets the current user's Gmail profile.
  • stop — Stop receiving push notifications for the given user mailbox.
  • watch — Set up or update a push notification watch on the given user mailbox.
  • drafts — Operations on the 'drafts' resource
  • history — Operations on the 'history' resource
  • labels — Operations on the 'labels' resource
  • messages — Operations on the 'messages' resource
  • settings — Operations on the 'settings' resource
  • threads — Operations on the 'threads' resource

Discovering Commands

Before calling any API method, inspect it:

# Browse resources and methods
gws gmail --help

# Inspect a method's required params, types, and defaults
gws schema gmail.<resource>.<method>

Use gws schema output to build your --params and --json flags.

Comments

Markdown supported