Skip to main content
Notion is a natural home for your team’s structured knowledge — product specs, runbooks, meeting notes, and project databases. Connecting Notion to Knoq means you can ask questions against that body of work in plain language, without leaving the chat. On Team and Business plans, Knoq can also write answers back to Notion, letting your AI-generated summaries live alongside the source material.

​
What Knoq can access

Knoq reads content from your Notion workspace through Notion’s official API, scoped to exactly what you share with the integration during setup:
  • Pages — any page you explicitly grant access to, including nested child pages
  • Databases — rows, properties, and their values in databases you share
  • Blocks — text, headings, toggles, callouts, and other block content within accessible pages
  • Comments and discussion threads on shared pages
  • Files embedded in accessible pages and databases
  • Workspace and team metadata such as page titles and last-edited timestamps
With write-back enabled (Team and Business plans), Knoq can also:
  • Create new pages in Notion databases or page hierarchies you authorize
  • Save AI-generated summaries and answers directly into your workspace
Knoq queries Notion in real time. Content is not indexed or cached — every query goes live to the Notion API at the moment you ask, so you always see the current state of your pages.

​
What Knoq cannot access

  • Pages and databases not shared with the Knoq integration during authorization
  • Pages in other Notion workspaces (each workspace requires its own connection)
  • Workspace admin settings, member billing, or user management data

​
Connect Notion

1

Open Settings → Integrations

In Knoq, click your avatar in the top-right corner, select Settings, then choose Integrations in the left sidebar.
2

Find the Notion connector

Locate the Notion card in the gallery. Use the Knowledge category chip to filter the list if needed.
3

Click Connect

Click the Notion card, then press Connect. Knoq redirects you to Notion’s OAuth authorization page.
4

Choose which pages to share

Notion’s authorization screen lets you select exactly which pages and databases Knoq can access. You can grant access to your entire workspace, specific top-level pages, or individual databases. Choose the scope that makes sense for how you want to use Knoq with Notion.
5

Click Allow access

After selecting your pages, click Allow access in Notion. You are redirected back to Knoq’s Settings → Integrations page.
6

Confirm the connection

The Notion card now shows a green Connected badge. Head to the Knoq chat and try searching your workspace.
If you grant Knoq access to a top-level page, it automatically includes all child pages nested beneath it — so you don’t need to share each page individually. Start broad and narrow down if you find Knoq surfacing content you’d rather keep out.

​
Searching Notion

Once Notion is connected, ask Knoq questions in plain language directly in the chat: 
Find our engineering onboarding doc in the People wiki

Summarize the latest product spec for the billing redesign

What are the open items in the Q4 roadmap database?

Show me all pages tagged "customer research" updated this month

What does our incident runbook say about database failovers?
Knoq returns a synthesized answer with references to the specific pages it read, so you can click through to verify or read more.

​
Writing back to Notion

On Team and Business plans, Knoq can save content back to your Notion workspace — for example, saving a meeting summary, creating a new task in a database, or adding an AI-generated doc outline to a page.
Write-back is not available on Free or Solo plans. To use this feature, upgrade to Team or Business. See concepts for plan details.
When write-back is available, you can ask Knoq things like “Save this summary to the Meeting Notes database” or “Create a new page in the Product Specs section with this content.” Knoq will describe what it’s about to create and ask for your confirmation before writing anything to Notion. For a complete guide to write-back — including how to set default target pages and manage write permissions — see the write-back guide.

​
Permissions

Knoq uses Notion’s page-level permission model, which means:
  • You explicitly choose which pages and databases to share during the OAuth flow
  • Knoq can only read or write within the scope you granted
  • You can expand or restrict that scope at any time by going to Settings → Integrations, disconnecting, and reconnecting with a different page selection
Access typeWhat it covers
ReadPages, databases, blocks, comments, and files you shared
Write (Team/Business only)Creating pages and database entries in locations you authorize
Knoq will never permanently delete pages or databases, modify workspace admin settings, or change sharing permissions without your explicit instruction. Write actions always include a confirmation step before Knoq makes any changes to your Notion workspace.