Notion Setup Guide
Connect Notion to Oskuo by creating an internal integration, then sharing the pages and databases you want Oskuo to access.
Prerequisites
- check_circle A Notion account (free or paid)
- check_circle Workspace owner or admin access so you can create integrations
- check_circle An active Oskuo account on any plan
Connecting Notion to Oskuo
- 1 Go to notion.so/my-integrations and click New integration. Give it a name (e.g. "Oskuo") and select your workspace. Click Submit.
-
2
On the integration page, copy the Internal Integration Token — it starts with
ntn_. - 3 Back in Notion, open each page or database you want Oskuo to access. Click the ... menu at the top right, then Connections, and search for your integration name (e.g. "Oskuo"). Repeat for every page or database you want to share.
- 4 Open Settings → Connectors in Oskuo, find Notion, and paste the integration token.
- 5 Click Test & Save. Oskuo will verify the token and confirm the connection.
What you can do
- check_circle Search pages and databases across your workspace
- check_circle Get the full content and properties of any shared page
- check_circle Retrieve content blocks from a page
- check_circle Create new pages in shared databases
- check_circle Update page properties (status, tags, dates, etc.)
- check_circle Append content blocks to existing pages
- check_circle Query databases with filters and sorting
- check_circle Create new databases within shared pages
- check_circle View database schemas and property definitions
Try it out
Here are some things you can ask Oskuo to do:
- chat_bubble "Search my Notion for meeting notes from last week"
- chat_bubble "Create a new page in my Tasks database"
- chat_bubble "What's in my Q2 planning doc?"
- chat_bubble "Show me all items in my Tasks database that are marked as 'In Progress'"
- chat_bubble "Add a summary section to the bottom of my meeting notes page"
Good to know
- info Oskuo can only see pages and databases that have been explicitly shared with the integration — it won't have access to your entire workspace by default.
- info Workspace settings, user accounts, and permissions can't be managed through Oskuo.
- info Comments on Notion pages can't be read or added through Oskuo yet.
- info Embedded files and images inside Notion pages aren't accessible — Oskuo works with text and database properties.
Keeping things secure
- lock Your integration token is encrypted with AES-256-GCM before it's stored — Oskuo never keeps it in plain text.
- lock Integrations only see pages you've explicitly shared with them. Share only what you need — nothing else is visible.
- lock You can revoke access at any time by removing the connection from individual pages or by deleting the integration entirely from the Notion developer portal.
- lock All requests to the Notion API are made over HTTPS, so your workspace data is encrypted in transit.
- lock You can regenerate your integration token at any time from the Notion developer portal. We recommend doing this every few months.
Troubleshooting
Oskuo returns no results when searching expand_more
The pages or databases you're looking for must be explicitly shared with the integration. In Notion, open each page, click ... → Connections, and add your integration. Sharing a parent page does not automatically grant access to sub-pages unless you enable sub-page inheritance.
Authentication fails with a 401 error expand_more
The integration token may have expired or been regenerated. Copy a fresh token from notion.so/my-integrations — it should start with ntn_. Update the token in Oskuo under Settings → Connectors.
Cannot create a page in a database expand_more
New pages can only be created inside databases that have been shared with the integration. Ensure the database is connected, and that the integration has Content capabilities: Insert content enabled in your integration settings.