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 databases for relevant information when creating suggestions—but it never modifies your Notion content.

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
• Database Queries: Promptless can query Notion databases to retrieve structured information like product roadmaps, feature specs, 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

When Notion is connected, Promptless agents gain access to three specialized tools:

Tool	Description
Search Notion	Searches pages and databases 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 Database	Queries rows from a Notion database, returning page IDs, titles, URLs, and properties. Returns up to 25 rows per request with pagination support.

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

Configure Notion scope in your Configuration page using the context_sources section:

context_sources:
  notion:
    source_type: notion
    database_ids:
      - abc123def456
    page_ids:
      - xyz789ghi012

An empty entry (or no entry) gives Promptless access to all pages and databases shared with your integration. Add database_ids or page_ids only when you need to restrict access.

Note

Promptless inherits the permissions of the Notion account used during OAuth connection and only accesses pages and databases you configure.

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 databases.

Setup Instructions

To connect Notion to Promptless:

1. Go to the Integrations page in your Promptless dashboard
2. Click Connect on the Notion integration card
3. Authorize Promptless to access your Notion workspace.
4. Select the specific pages and data sources you want to make available as context

To add or remove pages after initial setup, click Add or remove pages on Notion in the workspace picker. This deep links over into Notion so you can update your sharing selections.