| name | find-items |
| description | Find pages and databases in Notion - search, list, query database contents with filters |
| target | notion_agent |
Notion Discovery Tools
Use this skill to find pages and databases before creating or modifying content.
Core principle: ALWAYS discover before you act. Never assume or hardcode IDs.
When to Use
- User wants to find a specific page or database
- Before creating or modifying any Notion content
- User asks to query database with filters
- Need to verify page/database exists before operations
Tools
NOTION_FETCH_DATA
Primary discovery tool for listing pages and databases.
- fetch_type: "pages" | "databases"
- page_size: max results (default: 100)
- query: optional title filter
NOTION_SEARCH_NOTION_PAGE
Search across pages/databases by title or content (use if needed).
NOTION_FETCH_DATABASE
Get database schema (properties, types). Always call before inserting rows.
NOTION_QUERY_DATABASE_WITH_FILTER
Query database with property-based filters.
NOTION_QUERY_DATABASE
Query database rows without filters (retrieve all rows with pagination).
Workflow
Finding Pages/Databases
- NOTION_FETCH_DATA - List pages or databases (default: 100 results)
- If needed, use NOTION_SEARCH_NOTION_PAGE for broader search
Before Creating Content
- Find parent page/database ID
- Use NOTION_FETCH_DATABASE to get schema (required before inserting rows)
- Create or insert
Querying Databases
- Find database ID
- Use NOTION_QUERY_DATABASE to retrieve rows (or NOTION_QUERY_DATABASE_WITH_FILTER for filtered queries)
Tips
- Start with FETCH_DATA for overview, then SEARCH for specifics
- Always verify IDs before creating/updating
- Get schema first using NOTION_FETCH_DATABASE before inserting rows
- Handle multiple search results by asking user to clarify
