Gmail Tools¶

janito provides comprehensive tools for interacting with Gmail via IMAP.

Setup¶

Prerequisites¶

1. Enable IMAP in Gmail:
2. Open Gmail → Settings → See all settings → IMAP Access

3. Enable IMAP Access

4. Generate an App Password:

5. Go to Google Account Security
6. Enable 2-Factor Authentication if not already enabled
7. Go to App Passwords → Create a new app password

8. Use a name like "janito" to generate a 16-character password

9. Configure Secrets:

janito --set-secret gmail_username=your-email@gmail.com
janito --set-secret gmail_password=your-app-password

Available Tools¶

Usage¶

Enable Gmail Tools¶

# Interactive chat with Gmail
janito --gmail

# Single prompt with Gmail
janito --gmail "Show my unread emails from today"

Example Prompts¶

# Check unread emails
janito --gmail "Show my unread emails from today"

# Find emails from a sender
janito --gmail "Find emails from newsletter@example.com"

# Search by subject
janito --gmail "Search for emails with 'invoice' in subject"

# Count emails older than 30 days
janito --gmail "How many emails in inbox are older than 30 days?"

# Delete old spam (always safe to ask first!)
janito --gmail "Show me spam emails older than 90 days"

Gmail Labels/Folders¶

Common IMAP Queries¶

Tips¶

1. Always use dry_run=True first when deleting or moving emails
2. Use CountEmails before ReadEmails to check how many emails match
3. Trash is safer than Delete - emails in Trash can be recovered for 30 days

Troubleshooting¶

Authentication Errors¶

IMAP connection error: [AUTHENTICATIONFAILED]

• Verify you generated an App Password, not your regular Gmail password
• Check that IMAP is enabled in Gmail settings

Folder Not Found¶

Failed to select folder: folder-name

• Use ListFolders to get exact folder names
• Gmail labels are case-sensitive