Gmcli

What it does

Gmcli provides a command-line interface for interacting with Gmail. It allows an AI agent to programmatically perform actions like searching emails, reading threads, sending messages, and managing labels and drafts. The skill requires initial setup involving Google Cloud Console configuration and OAuth credentials.

When to use it

• Automating email searches based on specific criteria (e.g., finding all emails from a particular sender containing certain keywords).
• Retrieving complete email threads for review or analysis.
• Sending automated emails with customized subject lines and bodies.
• Listing available Gmail labels to understand the organization of your inbox.
• Managing drafts, such as listing them or potentially automating draft creation (though this isn't explicitly detailed).

Key capabilities

• Email searching using Gmail query syntax.
• Reading entire email threads by thread ID.
• Sending emails with specified recipients, subject lines, and bodies.
• Listing available labels within a Gmail account.
• Listing drafts stored in Gmail.
• OAuth authentication via JSON credentials file.

Example prompts

• "Search my inbox for emails from '[email protected]' containing the word 'urgent'."
• "Read the email thread with ID '1234567890abcdef.'"
• "Send an email to '[email protected]' with the subject 'Meeting Reminder' and body 'Don't forget our meeting tomorrow!'"

Tips & gotchas

• Initial Setup Required: Gmcli requires a Google Cloud project, enabled Gmail API, OAuth credentials (JSON file), and account setup before it can be used.
• OAuth Authentication: The skill uses OAuth for authentication; the --manual flag is available if browser-based authentication isn't possible.
• Data Storage: Credentials and tokens are stored locally in ~/.gmcli/credentials.json and ~/.gmcli/accounts.json.