Agent skill · software engineering · jeremylongshore
notion-search-retrieve
Analyze search intent and retrieve explicitly shared Notion pages or data sources while respecting search limitations and object identity. Use when locating content before a scoped read. Trigger with "search Notion", "find Notion page", or "retrieve Notion content".
Why this skill is useful
Provides specific commands and patterns for querying Notion databases and extracting content that the AI wouldn't reliably generate on its own.
What it needs
Requires @notionhq/client installed locally. Requires notion account access. About 2k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Notion Search and Retrieval Workflow Overview Analyze search intent and retrieve explicitly shared Notion pages or data sources while respecting search limitations and object identity.. This workflow produces an auditable decision or artifact before any live action. Prerequisites Current first-party Notion documentation and the selected integration's tested API-version contract. A named workspace owner, content or data owner, and operation owner. Synthetic or approved non-production fixtures with secrets and workspace content removed. Current Contract Current search returns shared pages and data sources, is title-oriented, paginated, and not guaranteed to reflect changes immediately. A specific structured dataset should be queried through its data-source endpoint instead. Recheck the dated evidence map before relying on mutable fields, endpoints, versions, limits, or delivery behavior. Authentication Use read capability and an approved shared-content scope. User fields and page bodies need separate minimization decisions. Instructions 1. Clarify whether the operator knows an exact ID, title fragment, database, or data-source identity. 2. Prefer exact-ID retrieval when provenance exists; otherwise run a type-scoped paginated search. 3. Record every page of candidates and disambiguate by object type, parent, and stable ID. 4. Retrieve only approved metadata, properties, blocks, or markdown required by the task. 5. Recursively traverse blocks only when requested and with depth, page, and byte bounds. 6. Return completeness limits, access gaps, and the selected object's evidence. Tool Discipline Use Read, Glob, and Grep to inspect documentation, configuration, code, fixtures, and evidence. Use Write and Edit only for approved repository artifacts. Invocation alone does not authorize network access, credentials, workspace content, user data, file transfer, deployment, capability or sharing changes, writes, spend, or deletion. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/notion-search-retrieve