Lesson 4. Notion: Database + Documents#
Goal: understand how to use Notion for agents when you need both data and documents.
What Is Notion#
Notion is a hybrid of a database, wiki, and workspace. You can:
- create databases (tables, boards, calendars)
- maintain documents (pages with text, images, embedded files)
- link databases and documents (customer database → customer page with history)
- collaborate with your team
When to Use Notion for Agents#
Use Notion when:
- you need database + documentation (customers + meeting notes)
- your team already uses Notion
- you need flexible views (table, board, calendar, gallery)
- you need context for the agent (e.g., agent reads a knowledge base from Notion pages)
How a Notion Database Works#
A Notion database is a collection of pages where:
- each page is one record (customer, task, project)
- each page has properties (name, status, date, tags)
- inside a page there can be content (text, tables, files)
Example: "Customers" database
- Properties: Name, Email, Status, Registration Date, Tags
- Page content: Meeting history, notes, contract files
How to Connect Notion to an Agent#
Step 1. Create a database
- create a page in Notion
- add a "Database" block (table, board, calendar)
- configure properties (name, text, number, date, status, tags)
Step 2. Get an API key
- go to developers.notion.com
- create an integration
- copy the Internal Integration Token
Step 3. Grant the integration access to the database
- open the database in Notion
- click
⋮(three dots) → "Add connections" → select your integration
Step 4. Connect via integration
- in Zapier / Make / n8n select the "Notion" module
- enter the API key
- choose the database
- configure action: "Read pages," "Create page," "Update page"
Step 5. Test
- run a test
- confirm data is read and written correctly
Example: Agent with Notion Knowledge Base#
Task: a support bot answers customer questions using a Notion knowledge base.
Structure:
- "Q&A" database in Notion
- Properties: Question (text), Category (tag), Answer (text in page content)
Agent logic:
- Customer asks a question in the bot
- Agent searches for a similar question in Notion (via text or tag search)
- If found → agent reads the page content (answer) and sends it to the customer
- If not found → agent suggests contacting support
Tools: Zapier (for chatbot) + Notion (for knowledge base) + integration via API or n8n.
Notion Limitations for Agents#
- Slow API (requests can take 1–3 seconds)
- No bulk operations (can't update 100 records in one request)
- API limits (3 requests per second on free tier)
Notion works well for small bases (up to 1,000 records) and tasks where context matters (documents + data).