> For the complete documentation index, see [llms.txt](https://help.botpenguin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.botpenguin.com/settings/third-party-apps/notion-mcp.md).

# Notion MCP

Notion lets your AI agent search your docs and databases for answers and add rows to a Notion database. You connect it once in Third party apps. Notion asks you to sign in and choose the pages to share, and the configuration is added. The agent can reach only the pages you share.

***

### Prerequisites

* A BotPenguin account with access to the More menu.&#x20;
* A Notion workspace.
* A pop-up blocker that allows the Notion sign-in window.

***

### Key Definitions

| Term               | Meaning                                                                               |
| ------------------ | ------------------------------------------------------------------------------------- |
| Third party apps   | The page in More where you connect other software to BotPenguin.                      |
| Shared pages       | The Notion pages you pick on the approval page. The agent can reach only these pages. |
| Connection         | One saved account that your agents can use.                                           |
| Connected accounts | The tab that lists every account you connected for this app.                          |

***

### Steps

1. Click **More** in the left menu, then click Third party apps.

![Click More, then Third party apps](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/BbduUgKfZcdil6dKE8I8/images/notion-step-1.png)

2. Type Notion in the search box, then open the **Notion** card.
3. On the Connected accounts tab, click **Add connection**. The Connect Notion panel opens.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FQsP2UALMW3g3OU45QSc0%2Fimage.png?alt=media&amp;token=f444cc5b-a211-45e4-b953-9d17cd3e5bcd" alt=""><figcaption></figcaption></figure>

4. In the panel, type a Connection name if you want one. Keep Sign in with Notion selected. Click **Continue with Notion** to start the Notion sign-in (OAuth) in another window. Sign in and approve access.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FGNkOPmvL5y0N4tQyj6hP%2Fimage.png?alt=media&amp;token=ae22ba1b-641f-4922-bbba-826f23a453e9" alt=""><figcaption></figcaption></figure>

5. When the sign-in is finished, the panel shows Connected as with your Notion email. Click **Save Configuration**.&#x20;
6. Check the Connected accounts tab. Your Notion account appears in the list with an Active status.

***

### Common Errors

<details>

<summary>I do not see Third party apps in the More menu</summary>

Click More in the left menu and look under Connections for Third party apps. If it is still missing, your role may not allow it. Ask your account owner.

</details>

<details>

<summary>The Notion sign-in window did not open</summary>

Your browser may have blocked the pop-up. Allow pop-ups for BotPenguin, then click Continue with Notion again.

</details>

<details>

<summary>Save Configuration is grey</summary>

You can save only after you sign in. Click Continue with Notion first, then wait for Connected as to show.

</details>

<details>

<summary>The sign-in window closed and Notion is not connected</summary>

You may have cancelled the approval, waited more than 10 minutes, or Notion refused the request. Click Continue with Notion again and finish the approval. The approval page must be completed within 10 minutes.

</details>

<details>

<summary>My agent cannot find a Notion page</summary>

The agent sees only the pages you shared on Notion's approval page. Click Add connection again and share the page, or share it in Notion.

</details>

<details>

<summary>Can I connect more than one Notion account?</summary>

Yes. Click Add connection again. Give each one a clear Connection name so you can pick the right one when you build an agent.

</details>

<details>

<summary>My agent says the connection needs to be reconnected</summary>

Access was removed in Notion, or Notion no longer accepts the saved sign-in, for example after a password reset. Add the connection again and sign in again.

</details>

***

### Support

Still not working? Write to us at <support@botpenguin.com>. We will reach out to you within 24 hours.
