Capabilities
| Feature | Description |
|---|---|
| AI Workspace Search | Search across pages and databases using natural language in chat |
| Create Pages | Create new Notion pages directly from AI chat |
| Sync Plans to Notion | Export Plans and documentation to your Notion workspace |
| Embed Pages in Plans | Insert live Notion page references in your planning documents |
| Documentation Publishing | Automatically sync generated documentation to Notion databases |
| Data Synchronization | Configure sync settings for pages, databases, and block content |
Connecting Notion
Start Connection
Click the Notion card to open the connection page, then click Connect Notion Account
Authorize Access
You’ll be redirected to Notion to authorize Kasava. Select the pages and databases you want to share, then click Allow access
Kasava uses secure OAuth authentication. Your Notion credentials are never stored—only an access token for API calls. You control which pages Kasava can access during authorization.
Managing Your Connection
After connecting, click Manage on the Notion integration card to access sync settings and connection options.Connection Status
The management dialog shows:- Connection status - Whether Kasava is connected to your workspace
- Workspace name - The name of your connected Notion workspace
- Last sync time - When data was last synchronized
Sync Configuration
Configure what data to sync from your Notion workspace:| Setting | Description |
|---|---|
| Historical Data (Days) | How many days of data to sync (1-365 days) |
| Sync Pages | Include Notion pages in synchronization |
| Sync Databases | Include Notion databases in synchronization |
| Sync Block Content | Include detailed block content (may take longer) |
Manual Sync
Click Sync Now to trigger an immediate synchronization. Large workspaces may take several minutes—you can close the dialog and the sync will continue in the background.Using Notion in AI Chat
Once connected, you can interact with your Notion workspace using natural language in Kasava’s AI chat.Searching Notion
Ask the AI to find content in your workspace:- “Find all Notion pages about the product roadmap”
- “Search for design documents in Notion”
- “What Notion pages mention authentication?”
- “Show me databases in my Notion workspace”
Creating Pages
Create new pages directly from chat:- “Create a new Notion page for the Q2 planning notes”
- “Add a page to my Engineering database for the API redesign”
- “Create a Notion document outlining the feature requirements”
Syncing Plans to Notion
Export Plans and documentation to your Notion workspace:- “Export this Plan to my Notion workspace”
- “Sync the authentication spec to Notion”
- “Create a Notion page from this PRD”
When syncing a Plan to Notion, Kasava links the two documents. Future sync requests can update the existing Notion page instead of creating duplicates.
Embedding Notion Pages in Plans
You can embed references to Notion pages directly in your Plans, keeping planning documents connected to your knowledge base.Inserting a Notion Page
- Open a Plan in the editor
- Type
/notionor click the + button and select Notion Page - Search for the page by title
- Click to insert the page reference
Notion Page Block
The embedded page reference displays:- Page icon - Emoji or image icon from the page
- Title - The page title (click to open in Notion)
- Parent - The parent page or database name
- Last edited - When the page was last modified
- Quick actions - Open in Notion, copy link, or remove
Using Page References
Embedded Notion pages help you:- Reference existing documentation in your Plans
- Link to design specs, research notes, or meeting minutes
- Keep Plans connected to your team’s knowledge base
- Quickly navigate to related Notion content
Documentation Publishing to Notion
When setting up automated documentation for a repository, you can publish generated docs directly to a Notion database.Configuring Notion as a Target
- Navigate to your repository’s Documentation settings
- Click Add Documentation Config
- In the wizard, select Notion as a target platform
- Enter your Notion database ID
- Optionally specify a parent page ID
Required Configuration
| Field | Description |
|---|---|
| Database ID | The ID of the Notion database where docs will be published |
| Parent Page ID | (Optional) Parent page for new documentation pages |
How It Works
When documentation is generated:- Kasava creates a new page in your specified Notion database
- Content is formatted with headings, lists, and code blocks
- The page is linked to the source repository for easy reference
Permissions
Kasava requests the following Notion permissions during OAuth:| Permission | Purpose |
|---|---|
| Read content | Search and view pages, databases, and blocks |
| Insert content | Create new pages and add content |
| Update content | Modify existing pages synced from Kasava |
Kasava can only access pages and databases you explicitly share during authorization. To share additional content, reconnect the integration and select more pages.
AI Features Available
With Notion connected, the AI assistant can:- Create and update Notion pages from chat
- Search across your workspace content
- Sync Plans and documentation to Notion
- Query databases and extract insights
- Find pages by title, content, or metadata
Disconnecting Notion
To disconnect your Notion workspace:- Go to Settings → Integrations
- Click on the Notion integration card
- Click Manage to open the settings dialog
- Click Disconnect Workspace
- Confirm the disconnection
Troubleshooting
Notion pages not appearing in search
Notion pages not appearing in search
Verify that you shared the relevant pages during OAuth authorization. To add more pages, disconnect and reconnect the integration, selecting additional pages to share with Kasava.
Connection shows 'Needs Re-auth'
Connection shows 'Needs Re-auth'
OAuth tokens expire periodically. Click the integration card and re-authorize to refresh your connection. You may need to re-select which pages to share.
Sync taking too long
Sync taking too long
Large workspaces with many pages can take time to sync. Try reducing the historical data period or disabling block content sync. The sync continues in the background—you can close the dialog.
Can't find a specific page
Can't find a specific page
Ensure the page was shared during OAuth authorization. Notion’s internal pages and private pages must be explicitly shared for Kasava to access them.
Plan sync creates duplicate pages
Plan sync creates duplicate pages
Enable the “Update existing” option when syncing to update a previously linked Notion page instead of creating a new one.
Security
Kasava handles Notion credentials securely:- All OAuth tokens are encrypted at rest
- Tokens are never exposed in the UI or logs
- You can revoke access anytime from Notion’s settings (Settings > My connections)
- Kasava only accesses pages you explicitly share during authorization