Notion

Connect Toby to Notion to search, read, create, and update durable document content from chat.

Notion ships as a first-party plugin bundled with Toby.app under ~/.toby/plugins/.

Prerequisites#

A Notion account and workspace
A Notion personal access token or internal connection token
Pages/databases shared with the Notion connection you want Toby to access

Get a Notion token#

Open the Notion developer portal.
Create a personal access token or internal connection for Toby.
Copy the token and keep it safe until you paste it into Toby.
In Notion, share the relevant pages or databases with the connection.

Do not commit the token to git. Toby stores it in ~/.toby/credentials.json and masks it in the UI.

Configure#

Open Toby.app → Settings → Integrations → Notion and enter:

Field	Description
API key	Internal integration token from your Notion integrations page
Default parent page	Optional page ID used when creating pages without an explicit `parentPageId`

Save the configuration.

Connect#

Click Connect on the Notion detail page. Toby validates the token with the Notion API, then marks Notion as connected.

Verify#

Return to Settings → Integrations. Notion should show as connected and healthy.

Chat capabilities#

Notion belongs to the Documents Provider category. Toby can:

Search accessible Notion pages and databases (searchNotion)
Fetch page metadata (getNotionPage)
List child blocks for a page or block (listNotionBlockChildren)
Create a page from markdown (createNotionPage)
Append markdown-derived content to an existing page (appendNotionPageContent)

Example prompts:

“Search Notion for the launch plan.”
“Create a Notion page with these meeting notes.”
“Append this decision log to the project page.”
“Find wiki pages about customer onboarding.”

You can scope chat to Notion in Toby.app by selecting Notion in the integration picker, or by leading with the integration name:

notion create a page for today's meeting notes

Documents provider defaults#

Open Toby.app → Settings → Providers and set Documents Provider to Notion when you want document/wiki/notes prompts to prefer Notion. This is especially useful for schedules that save recurring notes or search a knowledge base.

Disconnect#

Select Notion in Settings → Integrations and click Disconnect.