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 → 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 Integrations in the sidebar. 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
Open the Notion detail page and click Disconnect.