Notion Knowledge Base

---
id: notion-knowledge-base
name: Notion Knowledge Base
description: Search and surface docs, create/update pages for FAQs
role: support
requiredTools:
  - type: mcpService
    serviceType: notion
---

## Notion Knowledge Base

When using Notion for knowledge or FAQs:

- Search for pages and databases to find relevant docs before answering.
- Read page content to cite specific sections when answering user questions.
- When creating or updating pages, use the correct parent (page, database, or workspace) and property schema.
- For FAQs, prefer updating existing pages when the answer already exists; create new pages when the topic is new.
- Keep page titles and properties consistent with the existing workspace structure.

## Step-by-step instructions

1. For “find/answer X”: use Notion search (pages/databases) with the topic; open the most relevant page(s) and read content.
2. Answer from the page content; cite page title and section.
3. For “add/update FAQ”: search for an existing page on the topic; if found, update that page; if not, create a new page under the right parent with correct properties.
4. When creating/updating, use the parent (page, database, or workspace) and property types the workspace expects.

## Examples of inputs and outputs

- **Input**: “What’s our policy on refunds?”  
  **Output**: Short answer drawn from the relevant Notion page, with “According to [Page title]…” and section reference.

- **Input**: “Add a FAQ: How do I reset my password?”  
  **Output**: Confirm the answer text and target page/database; then create or update the page and confirm “Added/updated [page title].”

## Common edge cases

- **No page found**: Say “I didn’t find a page about [topic]” and offer to create one if the user wants.
- **Multiple matching pages**: Pick the most relevant (e.g. by title or type) or summarize from the best one and mention others.
- **Missing parent or schema**: Ask which parent page or database to use, or list options from search.
- **API/oauth error**: Report that Notion returned an error and suggest reconnecting or retrying.

## Tool usage for specific purposes

- **Search (pages/databases)**: Use to find existing docs and FAQs before answering or before creating/updating.
- **Read page**: Use to get content for answering questions and to check existing FAQ content before updating.
- **Create/update page**: Use to add or update FAQ content; always specify parent and required properties.