Notion
Notion integration provides read-only access to your team’s knowledge base for documentation automation. When Notion is configured as a context source, Promptless can search your Notion pages and data sources for relevant information when creating suggestions—but it never modifies your Notion content.
How It Works as Context Source
Section titled “How It Works as Context Source”When Notion is enabled as a context source:
- Page Search: Promptless searches your selected Notion pages for relevant content when creating documentation suggestions
- Data Source Queries: Promptless can query Notion databases (data sources) to retrieve structured information like product roadmaps, feature specs, or reference tables
- URL Resolution: When triggers reference Notion URLs, Promptless automatically fetches the linked page content using your authenticated connection. If a page isn’t shared with your Notion integration but is publicly accessible, Promptless falls back to fetching it as a public web page.
- Knowledge Context: Internal documentation, product specs, and team knowledge from Notion inform new documentation
Agent Capabilities
Section titled “Agent Capabilities”When Notion is connected, Promptless agents gain access to three specialized tools:
| Tool | Description |
|---|---|
| Search Notion | Searches pages and data sources shared with your Notion connection by keyword. Returns up to 25 results per request with pagination support. |
| Get Notion Page | Fetches a specific page by ID and returns its content as markdown. Optionally includes meeting note transcripts inline. |
| Query Notion Data Source | Queries rows from a Notion database, returning page IDs, titles, URLs, and properties. Returns up to 25 rows per request with pagination support. |
Example
Section titled “Example”When a GitHub PR references a Notion page containing feature specifications, Promptless automatically fetches that page content. It also proactively searches your Notion workspace for related product documentation, ensuring new docs align with existing feature definitions and terminology.
Configuration
Section titled “Configuration”Configure Notion context in your project settings:
- Connect your Notion workspace via OAuth during onboarding or from the Integrations page
- Select which Notion pages and data sources Promptless can access
- Promptless will only search content you explicitly select
Auto-include Options
Section titled “Auto-include Options”When selecting Notion content for a project, you can choose:
- All pages – Includes every Notion page shared with your integration, plus any new pages shared in the future
- All data sources – Includes every Notion database shared with your integration, plus any new databases shared in the future
These options let Promptless automatically access newly shared content without requiring you to update your project settings.
Note
Promptless inherits the permissions of the Notion account used during OAuth connection and will only access pages and data sources you explicitly configure in your project settings.
Data Privacy
Section titled “Data Privacy”Promptless queries Notion data in real-time and does not store any of your Notion content. All searches are performed on-demand when documentation updates are needed. Query results are cached briefly (90 seconds) to improve performance during a single documentation session, then discarded.
Promptless only reads from Notion—it never creates, updates, or deletes pages or data sources.
Setup Instructions
Section titled “Setup Instructions”To connect Notion to Promptless:
- Go to the Integrations page in your Promptless dashboard
- Click Connect on the Notion integration card
- Authorize Promptless to access your Notion workspace
- Select the specific pages and data sources you want to make available as context