gmailkit

A personal command-line tool for reading and managing my own Gmail accounts.

What it is

gmailkit is a single-user utility I wrote for myself. I have several Gmail accounts, and it lets me search, read, and organize them from one terminal instead of switching between browser tabs.

It is not a product, not a service, and not offered to anyone else. There is no hosted component: it runs locally on my own machine and talks directly to the Gmail API.

What it does

• Search and read mail across several accounts at once
• Apply labels, archive, and mark messages read
• Send and reply to messages
• Save attachments

How it handles credentials

OAuth refresh tokens are encrypted with AES-256-GCM. The key that decrypts them is kept in the macOS Keychain and never stored alongside the encrypted data. Short-lived access tokens are cached in a private, owner-only file outside the project directory.

Privacy

gmailkit collects nothing, transmits nothing to third parties, and has no analytics or servers. See the privacy policy for the full statement.