Notion Plugin for Dify

Overview

The Notion Plugin for Dify provides integration with Notion workspaces, allowing you to search, query databases, create and update pages directly from your Dify applications. It enables seamless interaction with your Notion content without leaving your Dify environment.

Features

• Search Notion: Search for pages and databases in your Notion workspace by keywords
• Query Database: Retrieve and filter content from specific Notion databases
• Create Page: Create new pages in your Notion workspace with custom title and content
• Retrieve Page: Get a specific page and its content by ID
• Update Page: Update an existing page's title or add new content
• Retrieve Database: Get database structure and schema information
• Create Database: Create a new database with custom properties and schema
• Update Database: Modify an existing database's title or properties
• Retrieve Comments: Get comments from a specific page or block
• Create Comment: Add a new comment to a Notion page

Configuration

1. Setting up Integration in Notion

Go to Notion Integrations and create a new internal integration or select an existing one.

Give your integration an appropriate name and select the workspace you want to connect it to.

For security reasons, you may want to limit the capabilities of your integration. For example, you can create a read-only integration by only enabling "Read content" permission:

Copy your "Internal Integration Secret" from the "Secrets" tab. You'll need this to configure the plugin in Dify.

Important: Keep this secret secure. Anyone with this token can access content shared with your integration.

2. Connecting Content to Your Integration

For your integration to access specific pages or databases, you must explicitly share them with your integration:

1. Navigate to the page or database you want to access through the plugin
2. Click the "•••" (three dots) menu in the top-right corner
3. Select "Add connections" and choose your integration from the list

Repeat this process for each page or database you want to access with the plugin.

3. Configuring the Plugin in Dify

1. In your Dify workspace, navigate to the Plugins section
2. Find and select the Notion plugin
3. Paste your Integration Secret in the configuration field
4. Save your configuration

Usage Examples

Search Notion

Query a Database

By default, returns up to records (default 10). To retrieve every matching record in the database, set , which automatically paginates through Notion's API. Each API call returns up to 100 records, and pagination is bounded by (default 500, so ~50,000 records max by default). The response includes if the cap was hit. When is enabled, the parameter is ignored. For large databases, consider tuning based on your expected record count to balance completeness with latency.

Create a Page

Retrieve a Page

fetches every block on the page, paginating
and recursing into blocks with (toggles, callouts, quotes, bulleted /
numbered list items, columns, etc.). It does not descend into /
blocks — those are separate resources and should be fetched
separately. Recursion is bounded by (default 5) and total Notion API
calls are capped by (default 500). The response includes
, , and , plus
if the cap was hit. Large or deeply-nested pages can take
several seconds; tune / for latency-sensitive contexts.

Update a Page

Retrieve Database Structure

Create Database

Update Database

Retrieve Comments

Create Comment

Supported Operations

1. Search: Find pages and databases across your workspace
2. Query Database: Retrieve and filter records from a specific database
3. Create Page: Create new pages with title and content
4. Retrieve Page: Get page details including properties and content blocks
5. Update Page: Modify page titles or append new content
6. Retrieve Database: Get database structure, schema and property types
7. Create Database: Create new databases with custom properties
8. Update Database: Update database title or modify properties
9. Retrieve Comments: Get comments from a page or block
10. Create Comment: Add comments to a page
11. Extract Data: Process various Notion property types including rich text, select, multi-select, etc.

Troubleshooting

• Authentication Errors: Make sure your integration token is valid and not expired
• Access Errors: Ensure the integration has been given access to the pages/databases you're trying to work with
• Not Found Errors: Check that the database or page IDs are correct and accessible
• Rate Limiting: If you receive rate limit errors, the plugin will automatically retry with backoff