gmail

Installation
SKILL.md

gmail

Headless Gmail access via the official Google API client. Every command is python3 scripts/gmail.py <subcommand> [flags] and prints JSON to stdout.

Authentication is non-interactive during normal use: the skill reads a ready-to-use credential from GOOGLE_CREDENTIALS_JSON and refreshes access tokens itself. If Google reports that the refresh token was expired or revoked, you can drive the re-authorization flow with the user: generate an auth link, ask the user to open it and paste the final redirect URL, then save the new credential with scripts/save_credentials.py.

Shares its auth layer (scripts/google_client.py, scripts/authorize.py) and the single GOOGLE_CREDENTIALS_JSON credential with the calendar skill. Authorize once and both skills work.

Setup

Installs
2
GitHub Stars
1
First Seen
Jun 19, 2026