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

# Notion

> Create pages and query databases from your agent

## Setup

<Steps>
  <Step title="Create an Internal Integration">
    1. Go to [notion.so/my-integrations](https://www.notion.so/my-integrations)
    2. Click **New integration** → choose **Internal** (not Public)
    3. Give it a name and select your workspace
    4. Copy the **Internal Integration Token**
  </Step>

  <Step title="Share pages with the integration">
    In Notion, open the pages/databases you want the agent to access → click **Share** → invite your integration.
  </Step>

  <Step title="Add credentials in Orova">
    Go to **Settings → Integrations → Notion** and paste your API token.
  </Step>

  <Step title="Create tool and assign">
    **Tools → Create Tool** → select **Notion** → assign to your agent.
  </Step>
</Steps>

<Warning>
  Use an **Internal** integration, not a Public one. Public integrations require OAuth which is not supported.
</Warning>

## Available tools

| Tool                   | Description                   |
| ---------------------- | ----------------------------- |
| `search`               | Search pages and databases    |
| `get_page`             | Get page content              |
| `create_page`          | Create a new page             |
| `update_page`          | Update page properties        |
| `query_database`       | Query a database with filters |
| `create_database_item` | Add an item to a database     |
| `get_block_children`   | Get page block content        |
| `append_block`         | Append content to a page      |