Skip to main content
Connect Notion to sync your documentation, wikis, and databases as knowledge for your agents.

​
Capabilities

CapabilitySupported
Knowledge Source✓ Sync pages and databases
Deployment Trigger✗
Tool Actions✗

​
Setup

​
Connect via OAuth

  1. Go to Settings → Connections in Duckie
  2. Find Notion and click Connect
  3. You’ll be redirected to Notion
  4. Select which pages/databases to share with Duckie
  5. Click Allow Access
  6. You’ll be redirected back to Duckie
You control exactly which pages Duckie can access. Only shared pages will be synced.

​
Selecting Content to Sync

When connecting, Notion asks you to select pages:

​
Option 1: Select Specific Pages

Choose individual pages or databases to share. This is the most secure approach.

​
Option 2: Select Parent Pages

Share a parent page to include all its children. Useful for entire documentation sections.

​
Option 3: Use Templates

If you have a documentation workspace, share the top-level template pages.

​
Syncing to Knowledge Base

After connecting:
  1. Go to Train → Knowledge
  2. Click Add Source
  3. Select Notion
  4. Choose from your shared pages
  5. Click Start Sync

​
What Gets Synced

  • Page content (text, headings, lists)
  • Database entries (as individual items)
  • Nested pages (if parent is shared)
  • Images (referenced, not embedded)

​
What Doesn’t Sync

  • Comments
  • Page history/versions
  • Permissions (all synced content is available to agents)

​
Keeping Content Updated

Duckie automatically re-syncs Notion content:
  • Incremental sync: Changes detected and updated
  • Sync frequency: Every few hours by default
  • Manual sync: Click “Sync Now” to force update

​
Best Practices

​
Organize for AI Readability

Structure your Notion pages for clear understanding:
  • Use descriptive headings
  • Keep pages focused on single topics
  • Link related pages together

​
Use Databases for Structured Info

Databases work great for:
  • FAQs (question + answer properties)
  • Product catalogs
  • Process documentation

​
Create a “Duckie Knowledge” Section

Consider creating a dedicated section in Notion:
  • Curated content specifically for support
  • Easy to maintain and update
  • Clear separation from internal docs

​
Example Structures

​
Support Documentation

📚 Support Docs (share this)
  ├── Getting Started
  │   ├── Quick Start Guide
  │   └── Installation
  ├── Features
  │   ├── Feature A
  │   └── Feature B
  └── Troubleshooting
      ├── Common Issues
      └── Error Messages

​
FAQ Database

Create a database with:
  • Question (Title)
  • Answer (Text)
  • Category (Select)
  • Last Updated (Date)

​
Troubleshooting

​
”Page not syncing”

  • Verify the page is shared with Duckie in Notion
  • Check that it’s selected in Knowledge sources
  • Try removing and re-adding the source

​
”Content out of date”

  • Click Sync Now to force a refresh
  • Check the last sync time in source details

​
”Missing nested pages”

  • Ensure the parent page is shared
  • Nested pages inherit sharing from parents