a new hire
An answer found across the wiki.
whyThe answer is somewhere in two hundred pages.
asksWhere does the wiki say how refunds are approved?
instibrain / works with / notion
Notion, edited under your own name.
A personal token reaches exactly the pages you can open, with no page to connect. Every edit shows your token's name.
team/tools/notion/notion.md ids and a token nameasked · an exampleAdd this quarter's three OKRs to the Goals database, same look as the rows above.
the AI, from the pageCopied a sibling row's icon and fields, then added three rows. History shows your token's name.
who uses it, and why
Who edits Notion through the AI.
Small, exact changes, by people who would rather not click.
an account manager
Call notes, filed where they belong.
whyNotes from a call end up in a chat.
asksAdd today's call notes inside the Acme toggle.
an engineer
One status changed, the page untouched.
whyThe spec is long, and one line changed.
asksMark the export spec as shipped.
what you can ask
Your AI reads and edits your Notion pages and databases as you.
Pages are read as structure first. Small changes go by patch, so history survives.
Search and read
Pages, blocks and databases, nested content included.
Edit a spot, not the page
Patch a block or a property. Rewrites are for overhauls.
Fill a database
Rows with matching icons, every free-text field read first.
Write inside a container
Content goes inside a toggle or callout, never below it.
Reference pages properly
As mentions that stay clickable through a rename.
Upload a file
Through Notion's own upload, so images stay permanent.
where the credential stays
A token in your own name.
The token reaches what you reach, nothing more.
in Notion, and in your secret store
Made on Notion's developer page, valid one year, pasted into your secret store. Notion's own connector gives the same reach. Guests cannot use either.
in your brain
A page names the workspace, its database ids, and the token's name.
what instibrain never touches
What the token never reaches.
It opens only what you can open. Our server stores the workspace page.
- The token on screen, in a page or in chat.
Read inside the call, so no shell history keeps it.
- A page you cannot open.
Notion refuses it. Your token sees only your pages.
- A rebuild that drops the images.
Images are re-uploaded before any page is wiped.
the limits
Your AI works at Notion's pace, with a full member's token.
Two limits of Notion's own.
| Limit | What it means |
|---|---|
| About three requests a second | So bulk work takes longer. |
| A token needs a full member | Guests become members first. |
before you connect it
Your AI opens only the Notion pages you can open.
Does instibrain connect to my Notion workspace?
No. Your personal token stays in your secret store, and opens only your pages.
What shows in Notion when the AI edits?
Your token's name, on every edit. The team sees who did what.
Can a guest use this?
No. Only a full member can make a token.
Your Notion, edited in your name.
Name the workspace and databases once. Claude Code and Codex then edit the right rows as you.
documents and filesGmail
Search, threads, drafts and cleanup, a send only on your go, through your own script.
documents and filesGoogle SheetsFormats, formulas, tabs and real dates, through your own script.
documents and filesGoogle DocsDocs edited in place, the writer's text untouched, through your own script.
documents and filesGoogle DriveFiles, sharing and shared drives, through the folder and your own script.
documents and filesGoogle Apps ScriptThe one script behind Gmail, Sheets, Docs, Drive and Calendar.
every kindWorks withEvery system by kind, and the rule each page shares.