Files
AutoGPT/docs/integrations/block-integrations/notion/read_database.md
Nicholas Tindle fdb7ff8111 docs(blocks): complete block documentation migration cleanup
Move remaining block docs to block-integrations/ subdirectory:
- Delete old docs from docs/integrations/ root
- Add new docs under docs/integrations/block-integrations/
- Add guides/ directory with LLM and voice provider docs
- Update SUMMARY.md with correct navigation structure

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-22 14:18:10 -06:00

2.2 KiB

Notion Read Database

Blocks for querying and reading data from Notion databases.

Notion Read Database

What it is

Query a Notion database with optional filtering and sorting, returning structured entries.

How it works

This block queries a Notion database using the Notion API. It retrieves entries with optional filtering by property values and sorting. The block requires your Notion integration to have access to the database.

Results include all property values for each entry, the entry IDs for further operations, and the total count. The database connection must be shared with your integration from Notion.

Inputs

Input Description Type Required
database_id Notion database ID. Must be accessible by the connected integration. str Yes
filter_property Property name to filter by (e.g., 'Status', 'Priority') str No
filter_value Value to filter for in the specified property str No
sort_property Property name to sort by str No
sort_direction Sort direction: 'ascending' or 'descending' str No
limit Maximum number of entries to retrieve int No

Outputs

Output Description Type
error Error message if the operation failed str
entries List of database entries with their properties. List[Dict[str, Any]]
entry Individual database entry (yields one per entry found). Dict[str, Any]
entry_ids List of entry IDs for batch operations. List[str]
entry_id Individual entry ID (yields one per entry found). str
count Number of entries retrieved. int
database_title Title of the database. str

Possible use case

Task Management: Query a Notion task database to find items with a specific status or assigned to a particular person.

Content Pipeline: Read entries from a content calendar database to identify posts scheduled for today or this week.

CRM Sync: Fetch customer records from a Notion database to sync with other systems or trigger workflows.