| name | notion-docs |
| description | Notion page search and reading. Use when searching for documentation, notes, or knowledge stored in Notion workspaces. |
| allowed-tools | Bash(python *) |
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]
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
python search.py --query "deployment process"
2. Research Before Answering
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