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

# Notion

> Let selected agents search, read, and update the Notion pages you approve.

Connect Notion to let an agent work with selected pages and databases. You choose what to share during Notion's sign-in
flow and which agents receive Notion tools in Mantle.

## What agents can do

<CardGroup cols={2}>
  <Card title="Find and read pages" icon="book">
    Search approved pages and databases, then read the content needed for an answer.
  </Card>

  <Card title="Work with databases" icon="table">
    Query records with filters and create or update records when you allow write access.
  </Card>

  <Card title="Create and edit content" icon="pen-to-square">
    Create pages, add content blocks, and update existing material.
  </Card>

  <Card title="Work with comments" icon="comment">
    Read comments and add a comment to an approved page or discussion.
  </Card>
</CardGroup>

## Connect Notion

<Steps>
  <Step title="Open integrations">Go to **Settings → Integrations** and select **Notion**.</Step>

  <Step title="Connect your account">
    Select **Connect**. Notion opens a permission screen where you choose the pages and databases Mantle can access.
  </Step>

  <Step title="Review the selection">Share only the material needed for the agents you plan to use.</Step>

  <Step title="Add tools to an agent">
    Open an agent, add Notion, and enable only the actions the role needs. Test a read request before allowing changes.
  </Step>
</Steps>

## Available tools

The exact tool list appears when you connect Notion. Common actions include:

| Area           | Common actions                                                    |
| -------------- | ----------------------------------------------------------------- |
| Pages          | Search, read, create, and update pages                            |
| Databases      | Query records and create or update databases and their properties |
| Content blocks | Read, add, update, and remove page content                        |
| Comments       | List comments and add a comment                                   |

Notion triggers are not currently available. You can use Notion tools in an agent chat or in a task started another way.

## Example uses

* Answer a team question from approved wiki pages and include a link to the source.
* Turn a Mantle discussion into structured meeting notes in a Notion database.
* Read a Notion project tracker and post a short status digest to a Mantle channel.

## Troubleshooting

<AccordionGroup>
  <Accordion title="The Notion sign-in page does not open">
    Allow pop-ups for Mantle and select **Connect** again. Check that your browser is not blocking the Notion window.
  </Accordion>

  <Accordion title="The agent cannot find a page">
    The page may not be part of the access you approved. Disconnect and reconnect Notion, then include the missing page
    or database on Notion's permission screen.
  </Accordion>

  <Accordion title="The agent can read but cannot edit">
    Check both the access granted in Notion and the Notion tools enabled for the agent. Add write access only if the job
    requires it.
  </Accordion>

  <Accordion title="The connection has expired">
    Go to **Settings → Integrations → Notion**, disconnect, and connect the account again.
  </Accordion>
</AccordionGroup>

<Card title="Back to integrations" icon="plug" href="/integrations/overview">
  View all integration guides.
</Card>