> ## Documentation Index
> Fetch the complete documentation index at: https://docs.knoq.one/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Notion to search and save pages in Knoq

> Connect your Notion workspace to search pages, databases, and blocks — and use write-back to save AI answers to Notion.

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

<Info>
  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.
</Info>

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

<Steps>
  <Step title="Open Settings → Integrations">
    In Knoq, click your avatar in the top-right corner, select **Settings**, then choose **Integrations** in the left sidebar.
  </Step>

  <Step title="Find the Notion connector">
    Locate the **Notion** card in the gallery. Use the **Knowledge** category chip to filter the list if needed.
  </Step>

  <Step title="Click Connect">
    Click the Notion card, then press **Connect**. Knoq redirects you to Notion's OAuth authorization page.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Click Allow access">
    After selecting your pages, click **Allow access** in Notion. You are redirected back to Knoq's **Settings → Integrations** page.
  </Step>

  <Step title="Confirm the connection">
    The Notion card now shows a green **Connected** badge. Head to the Knoq chat and try searching your workspace.
  </Step>
</Steps>

<Tip>
  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.
</Tip>

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

<Note>
  Write-back is not available on Free or Solo plans. To use this feature, upgrade to Team or Business. See [concepts](/concepts) for plan details.
</Note>

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](/guides/write-back).

## 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 type                    | What it covers                                                 |
| ------------------------------ | -------------------------------------------------------------- |
| **Read**                       | Pages, databases, blocks, comments, and files you shared       |
| **Write** (Team/Business only) | Creating pages and database entries in locations you authorize |

<Warning>
  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.
</Warning>