read-gmail

Read/search Gmail through local OAuth tokens. Supports multiple Gmail accounts with one shared OAuth client configured in .env.

Important

• Use the script in this skill directory; invoke with bun.
• Secrets may live in .agents/skills/read-gmail/.env; never print or read that file into chat.
• Token storage defaults to .agents/skills/read-gmail/.data/accounts/<email>.json; do not print token contents.
• .env and .data/ are gitignored.
• Prefer Gmail search syntax in search --query, for example from:alice@example.com newer_than:7d has:attachment.

Setup / status

From repo root:

bun .agents/skills/read-gmail/scripts/gmail.ts status