Notion

Tip

You can connect and scope this context source by hand as this page describes, or ask Promptless in Slack or Microsoft Teams to do it for you. For example, “@Promptless limit the Notion context source to my Product Specs database.” See Ask Promptless to update your configuration.

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 a 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

For many teams, Notion is the single source of truth—the workspace where product specs, PRDs, and structured databases define a feature before it ships. The spec, not the diff, holds the official names and rules a team has settled on.

A developer merges a GitHub PR that adds role-based permissions to your workspace settings. The feature was specced in Notion: an entry in your “Product Specs” database defines the official role names (“Owner,” “Editor,” and “Viewer”), the exact permissions each role grants, and the rules for who can change another member’s role.

When Promptless picks up the merged PR, it resolves the Notion page URL referenced in the PR description and queries your Product Specs database for the matching entry. Rather than inferring the details from the code alone, it reads the spec and carries the agreed-upon terminology into the documentation suggestion—the same role names, the same permission matrix, and the same constraints your product team defined. The result is a docs PR that matches the spec your team wrote in Notion instead of a re-derived approximation.

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.