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

# Notion

> Pages, databases and search, with an integration token. The Notion server above signs in instead.

Pages, databases and search, with an integration token. The Notion server above signs in instead.

## Connecting

In the dashboard, open **Connectors**, find Notion and press **Connect**. You will be sent to sign in; the connection is saved once that succeeds.

### What you will need

| Field | What it is |
| - | - |
| OAuth Client ID | Your Notion integration OAuth Client ID (for public integrations) |
| OAuth Client Secret | Your Notion integration OAuth Client Secret (for public integrations) |
| Internal Integration Token | Your Notion internal integration token (for private integrations) |

### Getting the credential

1. Go to [Notion Integrations](https://www.notion.so/my-integrations)
2. Create **Internal Integration** → Copy **Integration Token**
3. Share pages/databases with your integration (Settings → Add connections)
4. Add token to connector

## Notes

* Requires manual sharing of content with integration
* Rate limited to 3 requests/second
* Uses structured block hierarchy for content
* Supports rich formatting and nested structures

See [Notion API docs](https://developers.notion.com/docs/getting-started) for complete reference.

## What your AI teammate can do with it

| Tool | What it does |
| - | - |
| `search` | Search across all pages and databases |
| `get_databases` | List all databases (via search) |
| `get_database` | Retrieve a database by ID |
| `query_database` | Query a database for pages |
| `create_database` | Create a new database |
| `update_database` | Update database properties |
| `create_page` | Create a new page |
| `get_page` | Retrieve a page by ID |
| `update_page` | Update page properties |
| `get_page_property` | Retrieve a specific page property |
| `get_block_children` | Get children blocks of a block or page |
| `append_block_children` | Add children blocks to a block or page |
| `get_block` | Retrieve a block by ID |
| `update_block` | Update a block |
| `delete_block` | Delete a block |
| `get_users` | List all users in the workspace |
| `get_user` | Retrieve a user by ID |
| `get_me` | Get the current bot user info |
| `create_comment` | Create a comment on a page or discussion |
| `get_comments` | Retrieve comments for a page |

## Useful resources

* [Notion documentation](https://developers.notion.com/docs/authorization)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.