Skip to main content
gbrain
Sign in

Hook up a tool once. Use it from your command line.

Every agent you try wants its own copy of your keys, pasted into its own settings. Configure your tools once here and Claude Code, Cursor and your own terminal all run them, with permissions instead of passwords. 

# Install the CLI
curl -sSL https://gbrainio.terminalwire.sh | bash

# Sign in and connect your tools
gbrainio login

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

Every tool you use, from one terminal

Gmail, your calendar and the live web, each a command. The rest of the toolbox works exactly the same way.

Read and write your Gmail from the command line

brad@macbook · gbrainio 
gbrainio loginOpening your browser to connect this terminal.Or open this link in any browser:  https://gbrain.io/workspace/terminals/connect/SFMyNTY.g2gDbQAAABh0ZXJtWaiting for approval… (Ctrl+C to cancel)SIGNED IN  Brad's MacBook (org 1)  No services in this permission yet. Connect one with: auth grant <service>gbrainio auth grant gmailOpening https://gbrain.io/workspace/account/connections/google …Finish in the browser, then your gmail tools can read it.gbrainio tool gmail search --unread --newer-than 2dquery: newer_than:2d is:unread1. Your invoice from Rocketship, LLC   date: Thu, 27 Aug 2026 09:12:04 -0700   from: Stripe <receipts@stripe.com>   id: 198f2c1a9b7e4d02   snippet: Invoice A41C-0092 for $240.00 was paid automatically.   thread_id: 198f2c1a9b7e4d02   to: brad@gbrain.io2. Your August payouts are on the way   date: Wed, 26 Aug 2026 06:02:11 -0700   from: Stripe <notifications@stripe.com>   id: 198dbb40c7a1f88e   snippet: $4,182.55 will arrive in your account ending 4021 on Tuesday.   thread_id: 198dbb40c7a1f88e   to: brad@gbrain.io3. Tuesday   date: Wed, 26 Aug 2026 14:20:41 -0700   from: Jenny Okafor <jenny@example.com>   id: 198f4a7c02b31d55   snippet: Can we push Tuesday's review to noon? I have the planning...   thread_id: 198f4a7c02b31d55   to: brad@gbrain.iogbrainio tool gmail label 198f2c1a9b7e4d02 --name Receipts --createERROR   Not granted        File a message is not enabled for this client.FIX     This client can only use what you granted it. Run gbrainio permission to open the page where you turn on File a message, then run gmail label again.gbrainio permissionTurn tools on for this terminal here:  https://gbrain.io/users/7/clients/42/permissionsOpening it in your browser. Grant what you need, then run your command again.gbrainio tool gmail label 198f2c1a9b7e4d02 --name Receipts --createid: 198f2c1a9b7e4d02label: Receiptslabelled: trueremoved: falsegbrainio tool gmail move 198f2c1a9b7e4d02 --to archiveid: 198f2c1a9b7e4d02moved: archivegbrainio tool gmail draft --reply-to 198f4a7c02b31d55 --body "Noon works."drafted: trueid: r-8830219940512subject: Re: Tuesdaythread_id: 198f4a7c02b31d55to: jenny@example.com
One link, no token to copy. The browser asks for a name for this terminal and how long it stays signed in.

Check your calendar from the command line

Granted at Read, so it can tell you what the week looks like and cannot move anything on it.

brad@macbook · gbrainio 
gbrainio tool gcal ls --max-results 31. Standup                       09:302. Review with Jenny             12:003. Planning Commission hearing   13:00
Read only. Nothing on this plane can move an event.

Search the live web from the command line

Same terminal, same rules, pointed at the web.

brad@macbook · gbrainio 
gbrainio tool exa search "SF planning"1. Planning Commission — Agendas   https://sfplanning.org/hearings2. Supervisors — Land Use Committee   https://sfbos.org/land-use-committee
The live web, and the call is on the record like any other.

Those were three. Here is the whole toolbox.

Every one is a command, and every one obeys the same permission you just saw.

Give it to every agent, and stay in control

One setup reaches all of them. You decide what each may do, how long it lasts, and you can see everything it did.

The same tools work in every agent you use

Nothing is copied into any of them, so turning something off turns it off everywhere.

Brad's MacBook
On brad@gbrain.io Sep 26, 2026
Claude Code
On brad@gbrain.io Sep 19, 2026
Cursor
Not set up Nothing yet Sep 28, 2026
Hermes Mac Mini
Off brad@gbrain.io Aug 31, 2026
Cursor is connected but reaches nothing yet. The Mac Mini is switched off, and its access ended when it was.

An agent sees permissions, never your password

Your password and its access token never leave gbrain's servers. You set how far each agent goes instead.

brad@gbrain.io Google Remove

Gmail

Calendar

Web search Remove

Search the web

One agent's permission, across two accounts. Levels stack, so an agent that can file mail can also read it. Drive has no buttons because this account never granted it.

Lend your tools to an agent and keep control

You decide how long it lasts, and you can see everything it did.

Name this agent and choose how long it stays connected.

So you can tell it apart later, and know what to revoke.

Expires

It logs itself out after this, so nothing stays signed in forever. You can give it more time later.

How long it stays connected is the second thing you choose, before it reaches anything.
Hand them over for a day
Or a week, a month, a year. Access ends on its own, so trying an agent out is not a thing you have to remember to undo.
See what an agent actually did
Every tool call is on one list: which agent, what it touched, what it cost. Including the ones that were refused.
It cannot run away with it
Every agent has a daily limit on how many calls it can make. When it is reached the calls stop, and only a person can raise it.
Worked: Search "SF planning commission agenda" 1m ago Worked: Write a draft "jenny@example.com" 2m ago Worked: Move a message "archive" 3m ago Worked: File a message "Receipts" 4m ago Worked: Show who this client is completed 5m ago Refused: File a message "Receipts" 6m ago Worked: Search "newer_than:2d is:unread" 8m ago

Tool calls

118 of 500 today

118 of 500 118/500
Every call, which agent made it, and what it touched. The refused one sits with the ones that worked and says why it stopped.

Start with one command

The same toolbox works over MCP for agents that speak it. gbrain Tools is how the two fit together.

Sign in Read the full reference