Skip to content

Notion Connector

Key Concepts

The Notion Connector block allows your workflows to integrate directly with Notion, enabling the retrieval, filtering, and synthesis of structured content stored in Notion pages or databases.

This connector is ideal for leveraging knowledge bases, wikis, SOPs, and documentation hosted in Notion. By incorporating RAG (Retrieval-Augmented Generation) techniques, the block supports intelligent search and summarization of Notion content within your workflows.

Key Definitions

Term Definition
Notion Token A secure integration token used to authenticate access to Notion's API.
Notion Page ID A unique identifier for a Notion page or database to be included in the integration.
Workflow Node A discrete processing step that performs a specific task such as retrieve, rerank, or synthesize data.
RAG Retrieval-Augmented Generation, a technique combining document retrieval with LLM-based generation.

Setup Guide: Configuring a Notion Connection

To configure the Notion Connector, complete the following fields in the "New Notion Connector" screen:

1. Notion Page IDs

  • Enter the ID(s) of the Notion page(s) or databases to be connected.
    Example: abc123def4567890abcdef1234567890

  • You can include multiple page IDs if needed. Ensure each page is shared with the integration.

2. Notion Token

  • Enter your Notion integration token.
  • This token must have access to the specified pages or databases. You can generate it from your Notion integration settings and share the target pages with the integration.

3. Description

  • Provide a short description of the purpose or contents of the connection.
    Example: Internal SOPs and onboarding documentation from the operations team.

  • While optional for custom workflows, it's useful for routing and documentation.

4. Save

  • Click Save to complete the setup and return to the main workflow editor.

Workflow Nodes

The Notion Connector includes a series of nodes to enable intelligent retrieval and summarization of Notion content.

ingest_notion_configuration (First Node)

  • Initializes the connection by ingesting the configuration: token, page IDs, and filters.
  • Validates access and prepares the environment for content retrieval.

notion_retrieve_nodes

  • Retrieves content from the specified Notion pages or databases.
  • This includes page titles, blocks, table entries, or nested content depending on your structure.

notion_rerank_nodes

  • Reranks the retrieved content based on relevance to the user query or the workflow objective.
  • Helps surface the most relevant entries when working with large Notion spaces.

notion_synthesize (Last Node)

  • Synthesizes and formats the selected content into a structured output (e.g., summaries, bullet points, insights).
  • Supports downstream tasks such as chatbot responses, reporting, or further processing.

Best Practices for Effective Notion Integration

  • Use Specific Page IDs: Limit retrieval to pages or databases relevant to the task for faster results.
  • Share Pages with the Integration: Ensure that all target Notion pages are shared with your Notion integration.
  • Document Purpose Clearly: Add a description to help identify the function of the integration across teams.
  • Maintain Clean Structure: Structured Notion pages (headings, tables, bullets) improve the quality of synthesized results.

Example Use Case

To build an intelligent assistant for onboarding new employees:

  1. Configure the Notion Connector with a page ID that points to the Onboarding Wiki.
  2. A user query like "What are the steps for setting up a development environment?" triggers:
  3. notion_retrieve_nodes to fetch relevant sections from the wiki.
  4. notion_rerank_nodes to sort and prioritize content based on relevance.
  5. notion_synthesize to return a clear, step-by-step answer to the user or team member.