li3p/notion-search
skills/notion-search/SKILL.md
Search Notion for pages or databases by query using marknotion. Use when the user references a Notion page by name rather than URL, when locating a page to publish to or pull from, or when discovering what trackers and docs exist in the connected workspace.
documentation
Updated May 27, 2026
$ install --global
skillsauthnpx skillsauth add li3p/skills notion-searchInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 27, 2026, 2:05 AM21.4s1 file scanned
SKILL.md
- name:
- notion-search
- description:
- Search Notion for pages or databases by query using marknotion. Use when the user references a Notion page by name rather than URL, when locating a page to publish to or pull from, or when discovering what trackers and docs exist in the connected workspace.
Notion Search
Find Notion pages and databases by free-text query via the notion-search CLI
from the marknotion PyPI package, invoked through uvx so no install is
required.
Prerequisites
uvis installed. Ifcommand -v uvfails, stop and instruct the user to install it.NOTION_TOKENis set in the environment. If unset, stop and instruct the user to create an internal integration at https://www.notion.so/my-integrations and export the token.- Search results only include pages and databases that are connected to the integration. An empty result usually means the target was never shared with the integration, not that it does not exist.
Inputs
Resolve from $ARGUMENTS or by asking the user:
query: free-text query (required).--type pageor--type database(optional): narrow by object type.-n <N>(optional): cap the number of results. Default to a small N (5-10) to keep output readable.
Workflow
-
Verify prerequisites above.
-
Run the command:
uvx --from marknotion notion-search "<query>" [--type page|database] [-n <N>] -
Present results as a short list: title, type, ID or URL.
-
If the goal is to feed a downstream skill (
notion-publish,notion-pull), ask the user to confirm which result to use before proceeding.
When to use this skill internally
When notion-publish or notion-pull is invoked with a page name rather than
a URL or ID, call this skill first to resolve the name to an ID. Never guess
a page ID.
Reporting only. Do not modify any pages.
Related Skills
li3p/notion-pull
documentation
VerifiedTrustedCommunity
Export a Notion page to local Markdown using marknotion. Use when the user wants to pull a spec, design doc, meeting notes, or any Notion page into the repository as a Markdown file, or wants to read Notion content as context for a task.
SKILL.mdUpdated May 27, 2026
li3p/notion-publish
documentation
VerifiedTrustedCommunity
Publish a local Markdown file to a Notion page using marknotion. Use when the user wants to push README, docs, changelogs, or any Markdown content to Notion, either updating an existing page or creating a new one under a parent page.
SKILL.mdUpdated May 27, 2026
li3p/testmatch
testing
VerifiedTrustedCommunity
Generate tests that match an existing project's testing style. Use when adding coverage for a target file, function, bug fix, or edge case while preserving local conventions.
SKILL.mdUpdated Apr 23, 2026
li3p/ship
testing
VerifiedTrustedCommunity
Validate a branch and draft a pull request description from real commits and diffs. Use when preparing a PR, checking branch readiness, or writing reviewer-facing release context.
SKILL.mdUpdated Apr 23, 2026