Claude Code Plugins

Community-maintained marketplace

Feedback

gmail

@bentossell/bentos
0
0

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 Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name gmail
description 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.

Gmail CLI (gmcli)

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

gmcli <email> <command> [options]

Available Accounts

Commands

Search Emails

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:

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

gmcli <email> thread <threadId>
gmcli <email> thread <threadId> --download  # Download attachments

List Labels

gmcli <email> labels list

Modify Labels

gmcli <email> labels <threadIds...> --add LABEL --remove LABEL

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

Examples:

gmcli ben@factory.ai labels abc123 --remove UNREAD
gmcli ben@factory.ai labels abc123 --add STARRED

Send Email

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:

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

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

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/