Please report security issues by opening a private security advisory rather than a public issue.
We aim to acknowledge reports within 7 days.
gmail-cli is designed so that no secrets ever enter the repository or CI:
- OAuth client credentials and tokens are stored only on the local machine,
under
%APPDATA%\gmail-cli\(Windows) or~/.config/gmail-cli/(POSIX). - Token files are written with
0600permissions on POSIX systems. - The OAuth flow uses PKCE; the application is registered as a Desktop / Installed app, for which Google does not treat the client secret as confidential.
gmail-clirequests only thegmail.modifyandgmail.sendscopes. Permanent deletion of mail is not supported by design.
Never commit credentials.json, token.json, or any client_secret*.json
file. These patterns are excluded by .gitignore.