Query Data Source By Values
notion_query_data_source_by_valuesRead-only
Query Notion data sources using simple filters like Status equals Done or Tags contains AI, without writing raw Notion filter JSON. Automatically validates property names and value types.
Instructions
Query a Notion data source using simple schema-aware filters and sorts instead of raw Notion filter JSON. Use this after notion_inspect_data_source when the user asks for common queries like Status equals Done, Tags contains AI, Due on or before a date, Estimate greater than 3, or Done equals false. The server validates property names, option names, value types, and supported operators before calling Notion.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| match | No | How to combine multiple filters. all maps to Notion and; any maps to Notion or. | |
| sorts | No | Simple property sorts. | |
| format | No | Specify the response format. 'json' returns the original data structure, 'markdown' returns a more readable format. Use 'markdown' when the user only needs to read the page and isn't planning to write or modify it. Use 'json' when the user needs to read the page with the intention of writing to or modifying it. | |
| filters | No | Simple schema-aware filters. Multiple filters are combined with match=all by default. | |
| page_size | No | Number of results per page (max 100) | |
| start_cursor | No | Pagination cursor for next page of results | |
| response_mode | No | Controls response size for list-heavy tools. Use auto by default so the server returns compact summaries when the Notion response would be noisy. Use compact when IDs and summaries are enough. Use full only when raw Notion API objects are required for an advanced operation. | |
| data_source_id | Yes | The ID of the data source to query. It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-). |