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

# Notion

> Let the Rippit agent search your Notion workspace and write findings back into it.

Notion is the most connected server across Rippit customers, and the reason is usually the same: it is where the analysis is supposed to end up.

## What the agent gets

* **Workspace search**, including sources Notion itself has connected such as Slack, Google Drive, GitHub, and Jira.
* **Page and database reads**, with SQL-style querying over data sources.
* **Page and database writes**, if you enable them: create pages, update content and properties, add comments, create databases and views.
* **People and teams**, for resolving who owns what.

Typical uses: writing a recurring insights digest into a Notion page, checking whether a rising issue is already documented, or updating a tracker database from what the agent found in the conversations.

## Setup

Click **Connect** and sign in to Notion. Nothing to create first.

Notion's hosted MCP server is OAuth only. It does not accept integration or bearer tokens, so there is no application-identity option.

## Identity and scope

The connection acts as the Notion user who authorized it and can reach exactly what that person can reach, private pages included.

This matters more for Notion than for most connectors, because personal Notion workspaces tend to hold private notes alongside team content. If you are sharing the connection organization-wide, authorize with an account whose Notion access you are comfortable exposing to everyone.

## Tools

Notion exposes more than forty tools. The read set is enabled by default.

### Read

| Tool                                 | What it does                                                                                          |
| ------------------------------------ | ----------------------------------------------------------------------------------------------------- |
| `notion-ai-search`                   | Search Notion and connected sources such as Slack, Mail, and Calendar with one natural-language query |
| `notion-search`                      | Keyword search across the workspace, used when AI search is not available to the account              |
| `notion-fetch`                       | Retrieve a page, database, or data source by URL or ID                                                |
| `notion-query-data-sources`          | Query Notion databases with SQL                                                                       |
| `notion-query-multiple-data-sources` | Query two or more databases together with SQL joins and unions                                        |
| `notion-query-database-view`         | Run an existing view's filters, sorts, and columns                                                    |
| `notion-query-meeting-notes`         | Filter the current user's meeting notes                                                               |
| `notion-get-comments`                | Read comments and discussions on a page                                                               |
| `notion-get-users`                   | List workspace members and guests                                                                     |
| `notion-get-teams`                   | List teamspaces and membership                                                                        |
| `notion-list-recent-pages`           | Pages the user viewed recently                                                                        |
| `notion-list-favorite-pages`         | The user's favorites, in sidebar order                                                                |
| `notion-list-private-pages`          | The user's top-level private pages                                                                    |
| `notion-list-shared-pages`           | Pages shared directly with the user                                                                   |
| `notion-search-agents`               | Search Notion agents by name or description                                                           |
| `notion-search-skills`               | Find saved Notion Skills, the reusable task instructions a workspace keeps                            |
| `notion-download-attachment`         | Download a text attachment created by the MCP server                                                  |
| `notion-get-async-task`              | Check the status of a long-running operation                                                          |
| `notion-search-emails`               | Search the user's Notion Mail inbox                                                                   |
| `notion-view-thread-content`         | Read an email thread from Notion Mail                                                                 |

### Write

| Tool                           | What it does                                         |
| ------------------------------ | ---------------------------------------------------- |
| `notion-create-pages`          | Create one or more pages with properties and content |
| `notion-update-page`           | Update a page's properties or content                |
| `notion-create-comment`        | Comment on a page or specific content                |
| `notion-create-database`       | Create a database from SQL DDL or a typed template   |
| `notion-update-data-source`    | Change a data source's schema, title, or attributes  |
| `notion-create-view`           | Create a view on a database                          |
| `notion-update-view`           | Change a view's name, filters, sorts, or display     |
| `notion-duplicate-page`        | Duplicate a page within the workspace                |
| `notion-move-pages`            | Move pages or databases to a new parent              |
| `notion-create-folder`         | Create an empty folder under a parent page           |
| `notion-update-folder`         | Add or remove files in a folder, or add a subfolder  |
| `notion-create-attachment`     | Create and upload an attachment                      |
| `notion-create-file-upload`    | Get a short-lived URL for uploading a file           |
| `notion-convert-page-to-skill` | Mark a page as a Notion AI skill                     |

### Custom Agent sessions

Notion's own Custom Agents can be started and followed from Rippit. `notion-search-agents` finds the agent; the tools below run it and read what it produced.

| Tool                             | What it does                                         |
| -------------------------------- | ---------------------------------------------------- |
| `notion-spawn-session`           | Start a session with a published Custom Agent        |
| `notion-send-message-to-session` | Send a follow-up message to a session                |
| `notion-get-session-status`      | Check the latest turn's status without waiting       |
| `notion-wait-session`            | Wait for the latest turn to finish, up to 60 seconds |
| `notion-stop-session`            | Stop a running session                               |
| `notion-list-session-events`     | List short summaries of a session's saved events     |
| `notion-read-session-event`      | Read the full content of one saved session event     |
| `notion-query-sessions`          | List sessions, filtered by agent, status, or date    |
| `notion-search-sessions`         | Search past sessions by topic                        |

### Plan prompts

Notion gates a few capabilities behind its own Business and Enterprise plans. When one of them is out of reach, the server offers a card explaining what the workspace would need. These tools only render that card; they do not read or write anything.

| Tool                                       | What it does                                                          |
| ------------------------------------------ | --------------------------------------------------------------------- |
| `notion-check-mcp-next-steps`              | Return Notion's suggested next step when a fetch result points at one |
| `notion-show-advanced-analysis-next-steps` | Explain what querying across multiple data sources requires           |
