# Find Items

> Find pages and databases in Notion - search, list, query database contents with filters

- Skill: `theexperiencecompany/find-items` (Agent Skill)
- Install (CLI): `npx skillmds@latest add theexperiencecompany/find-items`
- Raw SKILL.md: https://api.skillmd.com/api/skills/theexperiencecompany/find-items/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: theexperiencecompany (https://skillmd.com/u/theexperiencecompany)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/theexperiencecompany/find-items

---


# 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
1. NOTION_FETCH_DATA - List pages or databases (default: 100 results)
2. If needed, use NOTION_SEARCH_NOTION_PAGE for broader search

### Before Creating Content
1. Find parent page/database ID
2. Use NOTION_FETCH_DATABASE to get schema (required before inserting rows)
3. Create or insert

### Querying Databases
1. Find database ID
2. 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