bentossell/bentos/gmail

Claude Code and agent skill by bentossell/bentos

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Gmail CLI for searching, reading threads, managing labels, and sending emails. Use when you need to check inbox, read emails, send messages, or manage email labels.

Install

npx vskill@latest install bentossell/bentos/gmail

SKILL.md

Gmail CLI (gmcli)

You have access to gmcli - a minimal Gmail CLI. All commands use the format:

bash
gmcli <email> <command> [options]

Available Accounts

  • ben.tossell@gmail.com
  • ben@bensbites.com
  • ben@factory.ai

Commands

Search Emails
bash
gmcli <email> search <query> [--max N]

Query examples:

  • in:inbox, in:sent, in:drafts
  • is:unread, is:starred, is:important
  • from:sender@example.com, to:recipient@example.com
  • subject:keyword
  • has:attachment
  • after:2024/01/01, before:2024/12/31
  • Combine: in:inbox is:unread from:boss@company.com

Examples:

bash
gmcli ben@factory.ai search "in:inbox" --max 10
gmcli ben@factory.ai search "is:unread" --max 50
gmcli ben@factory.ai search "from:someone@example.com has:attachment"
Read Thread
bash
gmcli <email> thread <threadId>
gmcli <email> thread <threadId> --download  # Download attachments
List Labels
bash
gmcli <email> labels list
Modify Labels
bash
gmcli <email> labels <threadIds...> --add LABEL --remove LABEL

System labels: INBOX, UNREAD, STARRED, IMPORTANT, TRASH, SPAM

Examples:

bash
gmcli ben@factory.ai labels abc123 --remove UNREAD
gmcli ben@factory.ai labels abc123 --add STARRED
Send Email
bash
gmcli <email> send --to <emails> --subject <s> --body <b> [options]

Options:

  • --to <emails> - Recipients (comma-separated, required)
  • --subject <s> - Subject line (required)
  • --body <b> - Message body (required)
  • --cc <emails> - CC recipients
  • --bcc <emails> - BCC recipients
  • --reply-to <messageId> - Reply to a message
  • --attach <file> - Attach file (can use multiple times)

Examples:

bash
gmcli ben@factory.ai send --to someone@example.com --subject "Hi" --body "Hello there"
gmcli ben@factory.ai send --to a@x.com --subject "Re: Topic" --body "Reply" --reply-to 19aea1f2f3532db5
Drafts
bash
gmcli <email> drafts list
gmcli <email> drafts get <draftId>
gmcli <email> drafts create --to <emails> --subject <s> --body <b>
gmcli <email> drafts send <draftId>
gmcli <email> drafts delete <draftId>
Get Gmail URL
bash
gmcli <email> url <threadIds...>

Notes

  • Thread IDs are returned from search results
  • Use --max to limit search results (default: 10)
  • Attachments download to ~/.gmcli/attachments/

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

7-day trend score
5

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/bentossell/bentos/gmail/badge)](https://verified-skill.com/skills/bentossell/bentos/gmail)

Something wrong with this skill or its page? Tell us.