incidentfox Notion Documentation
Authentication
Set the NOTION_API_KEY environment variable with a Notion internal integration token.
The integration must be connected to the pages/databases you want to access (via the "Connections" menu in Notion).
Available Scripts
All scripts are in .claude/skills/notion-docs/scripts/
search.py - Search Pages
python .claude/skills/notion-docs/scripts/search.py --query "onboarding" [--max-results 10]
# Examples:
python .claude/skills/notion-docs/scripts/search.py --query "engineering handbook"
python .claude/skills/notion-docs/scripts/search.py --query "team processes" --max-results 20
Client Library Functions
The notion_client.py module provides:
| Function | Purpose |
|---|---|
search_pages(query, max_results) |
Search across all connected pages |
get_page(page_id) |
Get page metadata |
get_page_content(page_id) |
Get all blocks (content) of a page |
Common Workflows
1. Find Documentation
# Search for topic
python search.py --query "deployment process"
# Get full content (using client library from Python)
# notion_client.get_page_content("page-id-here")
2. Research Before Answering
# Search for existing answers
python search.py --query "how to reset password"
Quick Reference
| Goal | Command |
|---|---|
| Search pages | search.py --query "topic" |
| Search with limit | search.py --query "topic" --max-results 20 |
Best Practices
- Integration access — The Notion integration must be connected to pages to see them
- Search is full-text — Notion searches page titles and content
- Use page IDs — After finding pages via search, use the page ID for full content retrieval