Notion Connect
Connect your Notion workspace. One token, two minutes.
How to Set Up
- User goes to notion.so/my-integrations
- Clicks + New integration
- Names it anything (e.g. "AI Assistant")
- Selects the workspace
- Clicks Submit → copies the Internal Integration Secret (starts with
ntn_) - Pastes it in the chat
Important: After creating the integration, the user must also share specific pages/databases with it:
- Open a Notion page → click
...menu → Connections → select the integration - This grants the integration access to that page and its children
AI Agent Flow
Check if configured:
python3 notion-connect/scripts/notion_connect.py --checkReturns JSON: {"configured": true, "workspace": "..."} or {"configured": false}.
Save token (after user pastes it):
python3 notion-connect/scripts/notion_connect.py --set-token "ntn_xxxxxxxxxxxxx"Saves to ~/.config/notion/config.json and verifies the token works by calling the Notion API.
When Notion is not configured, tell the user EXACTLY this:
"To connect Notion, I just need your Integration Token. It takes about 2 minutes:
- Open this page: https://www.notion.so/my-integrations
- Create a new integration (name it anything, like 'AI Assistant')
- After creating, go to Content access tab → Edit access → select the pages you want me to access
- Copy the Internal Integration Secret (starts with
ntn_) - Paste it here
For a detailed guide with screenshots: https://skillpack.gitbook.io/skillpack-docs/integrations/notion"
CRITICAL RULES
- NEVER ask the user for OAuth credentials — Notion internal integrations only need one token
- Always mention Content access — users must grant page access after creating the integration, otherwise it can't see anything
- Token starts with
ntn_— if the user pastes something else, it's wrong - Always show the Gitbook link when guiding setup
Credential Storage
| File | Path |
|---|---|
| Config | ~/.config/notion/config.json |
| Format | {"token": "ntn_...", "workspace_name": "...", "workspace_id": "..."} |
| Permissions | 0600 (user-only read) |
Follow-Up Questions
- "Search my Notion workspace for recent pages"
- "List my Notion databases"
- "Create a new page with meeting notes"