Notion

Connect Notion to your AI agent. It answers from the pages you share, with their properties and nested pages, in Slack, your helpdesk and chat.

eesel's AI agent for Notion answers questions from the Notion pages you share with it, and cites the page it used. It reads their text, their properties and the pages nested under them, and it answers in Slack, your helpdesk and your website chat.

Invite your AI teammate into Notion and it answers from the pages you share with it, and cites the page it used. It reads the full text of each shared page, the properties on it, and any pages nested under it. It answers when someone asks it.

Synced Notion pages feeding an answer in Slack.

Set up eesel in Notion

1

Ask your agent to connect Notion

Open the chat in your dashboard and ask it to connect Notion. It offers two ways in: signing in with Notion in your browser, which most teams use, or a token. The connection happens on the Integrations page, because it needs your browser, and your agent links you there. On that page, click Add integration, search for Notion, and pick the browser sign-in option. You can also start from Integrations in the left sidebar.

The dashboard chat with both ways to connect and the link.

Connect with a token instead

Use this when you would rather not sign in through the browser, or when someone already made a Notion connection.

1. In Notion, open Connections and click + New connection

2. Give it a name, pick Access token, and copy the token it generates. It starts with ntn_

3. In eesel, open Integrations, search for Notion, choose Connect with a token, and paste it in

The token on its own gives your agent nothing. A new Notion connection starts with access to no pages. Open a page in Notion, use its Connections menu, and add your connection by name. Pages nested under a shared page come along with it, including pages you add under it later. So sharing one high-level parent page is usually all you need.

One connection per Notion workspace is all you need. A second one for the same workspace adds nothing.

2

Approve it in Notion and choose your pages

The link opens Notion's own screen. Pick the Notion workspace you want, read the permission list, and click Select pages to access. The permission list covers more than reading, because that is Notion's wording for this kind of connection.

Notion's consent screen, with the workspace picker and permission list.

Next you choose the pages. Add each page you want answered from, then click Allow access. Only the pages listed here are shared. Pages nested under one of them come along with it, so a high-level parent page usually covers a whole area.

Notion's page picker with one page selected.

A person approves this in the browser.

3

Confirm the connection

Go back to the chat and tell your agent the connection is done. It attaches Notion to this agent, starts the download of your pages, says how many pages are indexed, and suggests a first question.

The chat confirming the sync and the page count.

Check it worked. The left sidebar now lists Notion under Integrations. From a terminal, eesel status shows the integration as connected with its source counts.

4

Check what it can read

Integrations > Notion shows the connection as Connected, with the Notion workspace name. Sources lists what your agent can read, as a Pages row with its own document count and toggle. Actions lists what it can do, as a Write group.

The Notion integration page, with the Pages row and the Write group.

5

Ask it something

Open the chat and ask a question only one of your Notion pages can answer. Your agent searches your knowledge, links the page it used, and lists its sources underneath.

An answer built from your Notion pages, with its sources listed.

6

Tell it how to answer

Tell your agent a standing rule in plain language and it saves the rule for next time. It says what it saved and links you to it.

A standing rule given in chat and saved.

The saved rule lives on the Instructions page, where you can read it and edit it by hand.

The rule on the Instructions page.

7

Use it where your team works

Your agent answers from the same Notion pages wherever it is working, and any rule you saved applies there too. A teammate can mention it in a Slack channel and get the answer in the thread. See Slack.

A Notion-based answer inside a Slack thread.

The chat bubble on your website draws on the same pages. See Chat bubble.

The chat bubble answering from the same Notion pages.

From Claude Code, Cursor or a terminal. The same setup works as commands: eesel login, then eesel integrations connect notion, which prints the details that connection method needs, including the sign-in link for a person to open. Then eesel integrations download start copies your pages in, eesel status shows the integration as connected with its source counts, and eesel chat asks it a question. Choosing pages in Notion and pasting a token have no command, so use the dashboard chat for those steps. The approval is a human step: print the link for a person, wait for the connection status to change, and do not retry the link. Full command reference: The eesel CLI. Step-by-step: Set up from Claude Code or the terminal. From an MCP client: Claude Code and MCP clients.

Sources and actions

Sources

Notion is a knowledge source. You pick the pages when you approve the connection, and you can take a page back out at any time. Everything your agent can read arrives on the integration page as the Pages row, with its own count and toggle. This is what that row holds.

Source	Description	Requires
Pages	The full text of every Notion page shared with the connection	The page listed when you approved the connection
Page properties	The properties set on each page, indexed alongside its text	As above
Nested sub-pages	Pages under a shared parent, picked up with the parent	A shared parent page

Databases are not synced. Your agent indexes Notion pages, not database objects. Content that only exists as rows in a database view is not indexed. Pages that live inside a database are still pages, so they sync normally once shared.

There is a cap of 15,000 pages per connection. Past that, the extra pages are left out rather than the sync failing. So narrow a very large Notion workspace to the pages you want answered from.

New pages do not arrive on their own. Your pages are indexed when you connect them. A page you create later under a shared parent is covered by that sharing, but it does not show up in your agent's answers straight away. If a new page matters and your agent does not seem to know about it, get in touch.

Every other integration on the agent is also a source. So a Notion answer can draw on Confluence, Google Drive, your helpdesk and your files at once. See Integrations.

Triggers

Notion has no triggers. Nothing that happens in Notion can start your agent. It answers from your Notion pages when someone asks it, in the dashboard, in Slack, and in the chat bubble.

Actions

Notion has one action, in a group called Write.

	Action	What it does
Write	Notion API request	Makes an authenticated request to your connected Notion workspace, so your agent can read or write a page, a database or a block

You stay in control the whole way. Adjust your AI agent's access to knowledge and its action permissions to your liking. See Actions and Approvals.

This is a general-purpose action rather than a named job like "create page", so decide carefully before you switch it on. Left off, your agent can never change anything in your Notion workspace.

Limitations

• Databases are not synced. Content that only exists as database rows is not indexed. Pages inside a database sync once shared.

• Up to 15,000 pages per connection. Pages past the cap are left out without an error.

• New pages do not show up straight away. A page created after you connect is covered by its parent's sharing, but is not in your agent's answers immediately.

• No triggers. Nothing that happens in Notion starts your agent.

• The Write action is general-purpose. It is a raw request to your Notion workspace rather than a named job, so decide carefully before you switch it on.

Troubleshooting

A page is not being answered from?

Almost always because the page, or a parent above it, was not shared with the connection. Open Integrations > Notion and check the Pages row has a document count. If you connect with a token, share the page from its Connections menu in Notion. Check you are inside the 15,000 page cap, because past it pages are left out without an error. A page you created after connecting does not appear straight away.

Answers are out of date?

Check the page was saved in Notion, and that it is still shared with the connection. If a page has been rewritten and your agent still gives the old answer, get in touch.

Nothing synced at all after connecting?

A fresh Notion connection starts with access to no pages. If you approved the connection but listed no pages, there is nothing to read. The same goes for a token you pasted but never shared a page with. Content that only exists as database rows does not sync either. Put it on a page and share that page.

Notion's permission list looks broader than reading?

That is Notion's own wording for this kind of connection, and every app that connects this way gets the same list. Your agent reads the pages you listed.

FAQ

How do I add an AI agent to Notion?

Connect Notion to eesel and share the pages you want answered from, and your eesel agent answers from them. Ask it in the dashboard chat to connect Notion, sign in with Notion, and pick your pages on Notion's consent screen. See Set up eesel in Notion.

Can I connect Notion to ChatGPT or Claude?

Yes, through eesel. Once Notion is connected, you can talk to your eesel agent from Claude, ChatGPT or Cursor, and it answers from your Notion pages. See Use eesel from Claude and other assistants, Use eesel from ChatGPT and Claude Code and MCP clients.

Is eesel the same as Notion AI?

No. Notion AI is Notion's own assistant, used inside Notion. eesel is a separate AI agent that reads the Notion pages you share and answers from them in Slack, your helpdesk, your website chat and the eesel dashboard.

Do I need a Notion token to connect?

No. Signing in with Notion in your browser is the primary way to connect, and it needs no keys. The token method is there for teams that would rather paste a token, or that already made a Notion connection.

Do I have to list every Notion page when I approve the connection?

No. Listing a high-level parent page brings every page nested under it along with it, including pages you add later.

Are Notion databases synced?

No. Your agent indexes Notion pages, their text and their properties. The database object itself is not synced. Pages that sit inside a database still sync as ordinary pages once they are shared.

What happens when I add a new page in Notion?

It is covered by its parent's sharing, but it does not show up in your agent's answers straight away. If it sits under a page you already shared, you do not need to share it again. If a new page matters and your agent does not seem to know it exists, get in touch.

Is there a limit on how many Notion pages I can sync?

Yes, 15,000 pages per connection. Past that the extra pages are left out without the sync failing. On a very large Notion workspace, share a narrower set of pages.

Can my agent write to Notion?

Only if you let it. Notion has one Write action. Left off, your agent reads the pages you shared and can never create, edit, comment on or delete anything.

Related pages

• Internal operations

• Actions and Approvals

• Integrations overview

• Set up from Claude Code or the terminal