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

# Notion

> Connect a Notion workspace as a knowledge base source for Workflows — browse pages and tag the ones AI skills should pull as context.

## Overview

The Notion integration lets you browse pages in a connected Notion workspace and tag specific ones with free-text context tags (e.g. `pr-review`). Tagged pages become available as context to [AI skills](/features/workflows) — Pwnbook never edits or manages your Notion content, it only reads and tags for reference.

## Prerequisites

* A Notion workspace
* Admin or Owner access in Pwnbook (for org setup)

## Setup

<Steps>
  <Step title="Create a Notion internal integration">
    1. In Notion, go to **Settings → Connections → Develop or manage integrations**.
    2. Click **New integration**, give it a name like "Pwnbook", and select the workspace.
    3. Copy the **Internal Integration Secret**.
  </Step>

  <Step title="Share pages with the integration">
    In Notion, open each page (or a parent page covering everything you want visible) and use **Share → Connections** to add your new integration. Notion's API only returns pages explicitly shared with the integration.
  </Step>

  <Step title="Configure the org connection">
    1. Go to **Organization Settings → Marketplace → Notion**.
    2. Paste the **Internal Integration Secret**.
    3. Click **Save**.
  </Step>
</Steps>

## Browsing and tagging pages

1. Open **Notion** from the sidebar (**Sources** section).
2. Search or browse the pages your integration has access to.
3. Click **+ tag** on any page and enter a tag (e.g. `pr-review`, `security-standards`).

Tags are free text — use whatever convention makes sense for your [workflow rules](/features/workflows) and skills.

## What's available

| Feature                | Description                                                                                |
| ---------------------- | ------------------------------------------------------------------------------------------ |
| **Page browse/search** | List and search pages shared with the integration                                          |
| **Tagging**            | Assign one or more free-text context tags per page                                         |
| **Skill context**      | Tagged pages are pulled as reference material by AI skills that declare access to that tag |
