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

# Notion

> Set up a Notion internal integration for the Notion resource.

## Credentials

### 1. Create an Internal Integration

1. Go to [My Integrations](https://www.notion.com/my-integrations)
2. Click **+ New integration**
3. Name it (e.g. "mirage"), select your workspace
4. Under **Content Capabilities**, enable:
   * **Read content** (required)
   * **Update content** (for write commands)
   * **Insert content** (for `notion-comment-add`)
5. Click **Save changes**
6. Copy the **Internal Integration Secret** (starts with `ntn_`)

### 2. Share Pages with the Integration

The integration has no access by default. You must share each page:

1. Open a Notion page you want to mount
2. Click `...` (top-right) -> **+ Add connections**
3. Search for your integration name and select it
4. Child pages inherit the connection - share a top-level page to expose its entire subtree

### 3. Set Environment Variables

```bash theme={null}
# .env.development
NOTION_API_KEY=ntn_xxxx...
```

For Python configuration, see the [Python Notion Setup](/python/setup/notion) guide.