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 |
|---|---|
| Notion API Key | Personal access token or internal connection token |
| Default Parent Page ID | Optional parent page 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 → Default 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.