Notion

Connect Notion with one-click sign-in so your agent answers from the pages you share with it, including their properties and nested pages, and cites the page it used.

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.

Nothing in Notion starts your agent. It answers when someone asks it. Notion has no triggers, and its one Write action stays off until you turn it on.

Synced Notion pages feeding an answer in Slack.

Quick start

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. The one Write action that could change anything is off until you turn it on.

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 set to Disabled.

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. Every action runs on its own, asks you first, or stays off. This one is off when you connect.

	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

This is a general-purpose action rather than a named job like "create page", so decide carefully before you switch it on. Set it to ask you first and every use waits for a person, with Approve, Always allow and Deny in the dashboard. Left off, your agent can never change anything in your Notion workspace. See Actions and Approvals.

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. The one Write action is off until you turn it on.

FAQ

Do I have to list every 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.

Do I need a Notion token?

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.

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?

If it sits under a page you already shared, that sharing covers it, so you do not need to share it again. It does not show up in your agent's answers immediately. 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 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, and it is off when you connect. Left off, your agent reads the pages you shared and can never create, edit, comment on or delete anything. Switch it on and you choose whether it runs on its own or asks you first.

How is Notion billed?

Connecting Notion as a knowledge source carries no charge of its own. You are billed for the work your agent does. A ticket or conversation it handles is one task, and chats you run yourself from the eesel dashboard are free. See Pricing.

Related pages

• Internal operations

• Actions and Approvals

• Integrations overview

• Set up from Claude Code or the terminal