Gday

gday - Gmail & Google Calendar CLI

Use this skill when users ask about their Gmail or Google Calendar. This includes:

• Finding, searching, or reading emails
• Checking inbox or unread messages
• Sending emails or replies
• Viewing calendar events (today, tomorrow, this week)
• Creating or deleting calendar events
• Searching for specific emails or events

Prerequisites

The gday CLI is installed at ~/.local/bin/gday.

The user must have authenticated:

gday auth status  # Check if authenticated
gday auth login   # Authenticate if needed

Gmail Commands

# List recent emails
gday mail list                    # 10 recent emails
gday mail list -n 25              # 25 emails
gday mail list --unread           # Only unread
gday mail list --json             # JSON output for parsing

# Read an email
gday mail read <message-id>       # Read message
gday mail read <id> --json        # JSON output

# Search emails (Gmail search syntax)
gday mail search "from:someone@example.com"
gday mail search "subject:invoice"
gday mail search "gift card"
gday mail search "has:attachment filename:pdf"
gday mail search "is:unread after:2024/01/01"

# Read a thread
gday mail thread <thread-id>

# Send email
gday mail send --to user@example.com --subject "Subject" --body "Message"

# Reply to email
gday mail reply <message-id> --body "Reply text"

# List/download attachments
gday mail attachment <message-id>           # List attachments
gday mail attachment <message-id> --all     # Download all

# List labels
gday mail labels

Calendar Commands

# View events
gday cal today                    # Today's events
gday cal tomorrow                 # Tomorrow's events
gday cal week                     # This week's events
gday cal list                     # Next 10 events
gday cal list -n 20 --days 30     # Next 20 events in 30 days
gday cal list --json              # JSON output

# Show event details
gday cal show <event-id>

# Create events
gday cal create --quick "Lunch tomorrow at noon"
gday cal create --title "Meeting" --start "2024-01-15 14:00"

# Search events
gday cal search "meeting"
gday cal search "John" --days 90

# Delete event
gday cal delete <event-id>

# List calendars
gday cal calendars

JSON Output

All commands support --json for machine-readable output. Use this when you need to parse or analyze the data:

gday mail list --json | jq '.messages[] | select(.is_unread)'
gday mail search "gift card" --json
gday cal today --json

Common Patterns

Find specific emails:

gday mail search "from:amazon subject:gift card" --json

Check for unread from specific sender:

gday mail search "from:boss@company.com is:unread"

Get today's schedule:

gday cal today --json

Quick calendar event:

gday cal create --quick "Call with Sarah Friday 2pm"

Converted and distributed by TomeVault — claim your Tome and manage your conversions.