gbrain

Sign in

Gmail

Gmail from the command line.

Search, read, file and draft mail from a terminal or an assistant.

Reading is one grant and changing is another, so a client can search a mailbox for months without ever being able to touch it. Sending is a third, and most setups never turn it on: a draft lands in Drafts and waits for a person to press send.

Four commands

Each of the last three opens a browser tab, does one thing, and hands the terminal back.

$ curl -sSL https://gbrainio.terminalwire.sh | bash   # install it
$ gbrainio login                                      # name this terminal, pick how long it lasts
$ gbrainio auth grant gmail                           # connect the account
$ gbrainio permission                                 # turn Gmail on

The installer is a shell script. Read it first. macOS and Linux.

Then these

Read from the tool plane, so this list is what the CLI answers to today. Add -h to any of them for its arguments.

gbrainio tool gmail search: Search your email
gbrainio tool gmail read: Read a message
gbrainio tool gmail send: Send email
gbrainio tool gmail labels: See your labels
gbrainio tool gmail draft: Write a draft
gbrainio tool gmail drafts: See your drafts
gbrainio tool gmail label: File a message
gbrainio tool gmail move: Move a message
gbrainio tool gmail mark: Mark a message

Same tools, any assistant

Claude Code, Cursor and Codex reach the same Gmail through MCP, on the same permission and the same record.

How the whole thing fits

One permission, one daily ceiling, one record, across every client that asks.

Also on the plane

Google Calendar List, add, change and cancel events without leaving the terminal.
Web search Search the live web and get back text, not a page of links.
Page fetching Turn a URL into readable text, including pages that need a browser.
Google Drive Not yet Not connected yet.