gmail +triage

SkillCommunication

gws-gmail-triage is a skill that lets an AI agent show a summary of unread Gmail messages. It lists each message with its sender, subject, and date so you can see what is waiting without opening your inbox. The skill focuses on unread mail only and does not read or change messages.

Use gmail +triage in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add gmail +triage and connect your AI. About a minute.

Also: Claude Code · Cursor · Codex

Then ask your AI: use the gmail +triage skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Have an AI agent that can load skills.

gmail +triageStart free

What your AI can do with it

  • Show unread Gmail messages in a summary list
  • Include the sender of each unread message
  • Include the subject line of each unread message
  • Include the date of each unread message

Getting started

  1. Have an AI agent that can load skills.
  2. Add the gws-gmail-triage skill to that agent.
  3. Configure the agent with access to the Gmail account you want summarized.
  4. Ask the agent to show a summary of unread Gmail messages.

What this skill tells your AI

The instructions your AI receives, as published by googleworkspace/cli in skills/gws-gmail-triage/SKILL.md and read by Ahel’s review.

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

Show unread inbox summary (sender, subject, date)

Usage

gws gmail +triage

Flags

FlagRequiredDefaultDescription
--max—20Maximum messages to show (default: 20)
--query——Gmail search query (default: is:unread)
--labels——Include label names in output

Examples

gws gmail +triage
gws gmail +triage --max 5 --query 'from:boss'
gws gmail +triage --format json | jq '.[].subject'
gws gmail +triage --labels

Tips

  • Read-only — never modifies your mailbox.
  • Defaults to table output format.

See Also

Signals

GitHub stars
31k
Forks
2k
Last commit
Sep 2026

Ahel review

  • S4info
    community integration, published by googleworkspace, not gmail

Automated review, not a security audit. Ruleset v1+k2.

Questions

Does it show read messages?
No. It only shows unread messages in the summary.
Can it send or reply to email?
No. It only shows a summary of unread messages and does not send, reply, or modify anything.
What details are included for each message?
Each unread message is listed with its sender, subject, and date.
Can it mark messages as read?
No. It does not change the read state of any message.
Advanced
Item type
skill
Key
gws-gmail-triage
Source
github.com/googleworkspace/cli