notion-connect

Original：🇺🇸 English

Translated

1 scriptsChecked / no sensitive code detected

Set up Notion integration token. Use when Notion commands fail with auth errors, or when user wants to connect their Notion workspace. Takes 2 minutes — user creates an integration at notion.so/my-integrations and pastes the token.

2installs

Sourcecreminiai/cremini-skills

Added on2026-04-18

NPX Install

npx skill4agent add creminiai/cremini-skills notion-connect

SKILL.md Content

View Translation Comparison →

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:

bash

python3 notion-connect/scripts/notion_connect.py --check

Returns JSON:

{"configured": true, "workspace": "..."}

or

{"configured": false}

.

Save token (after user pastes it):

bash

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"