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

# Notion

> Search, read, and create pages in Notion workspaces

## At a glance

* **Availability**: Enabled by default.
* **Auth**: OAuth 2.0.
* **Connection**: A user authorizes the connection in the provider's consent screen.

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

With a managed OAuth app, Connect works without these variables; set them to use your own OAuth app instead.

| Variable               | Required | Description                                                                                   |
| ---------------------- | -------- | --------------------------------------------------------------------------------------------- |
| `NOTION_CLIENT_ID`     | Yes      | Notion OAuth Client ID (from your integration) [Docs](https://www.notion.so/my-integrations). |
| `NOTION_CLIENT_SECRET` | Yes      | Notion OAuth Client Secret [Docs](https://www.notion.so/my-integrations).                     |

## Tools

| Tool              | Access | Description                                                                           |
| ----------------- | ------ | ------------------------------------------------------------------------------------- |
| Search Notion     | Read   | Search pages and databases in the workspace                                           |
| Read Page         | Read   | Read the content of a Notion page                                                     |
| Create Page       | Write  | Create a new page in a database or as a subpage                                       |
| Query Database    | Read   | Query a Notion database with filters and sorts                                        |
| Get Page Metadata | Read   | Retrieve Notion page metadata and properties without fetching child block content     |
| Get Database      | Read   | Retrieve Notion database metadata, title, and property schema                         |
| Append Blocks     | Write  | Append child blocks to a Notion page or block                                         |
| Update Page       | Write  | Update Notion page properties or archive/unarchive a page                             |
| Create Database   | Write  | Create a new Notion database as a subpage with a property schema                      |
| List Users        | Read   | List users in the Notion workspace so pages can mention or attribute the right person |

## Example prompts

* Search my Notion workspace for relevant documentation or notes about a topic.
* Read and summarize a specific Notion page. Extract the key points and action items.
* Create a new meeting notes page with today's date, attendees, agenda, and action items sections.