email

name	email
description	Send and read emails via Gmail API with OAuth2. Compose, send, list inbox, read messages, and search emails from the terminal.
homepage	https://developers.google.com/gmail/api
metadata	{"openclaw":{"emoji":"📧","requires":{"bins":"[Truncated]","env":"[Truncated]"},"primaryEnv":"GMAIL_CREDENTIALS_FILE","install":["[Truncated]"]}}

Gmail Email Agent

Send and read emails via the Gmail API using OAuth2 authentication.

Google Cloud Setup (one-time)

1. Go to Google Cloud Console
2. Create a new project (or select an existing one)
3. Enable the Gmail API:
   • Navigate to APIs & Services > Library
   • Search for "Gmail API" and click Enable
4. Create OAuth2 credentials:
   • Go to APIs & Services > Credentials
   • Click Create Credentials > OAuth client ID
   • Application type: Desktop app
   • Download the JSON file
5. Save the credentials file and set the env var:

# Save the downloaded JSON somewhere safe
mv ~/Downloads/client_secret_*.json ~/.config/gmail-credentials.json

# Set the environment variable
 GMAIL_CREDENTIALS_FILE=~/.config/gmail-credentials.json