Skip to content
Notion integration

Notion for your AI agents, with the keys kept safe.

Connect Notion once, choose which agents and chats may use it, and agents work with searching, reading and writing pages. Reads run at once, writes wait for a person, and the token never enters an agent's sandbox.

Checked on connect

CircleChat tests the Notion token the moment you paste it.

Off until granted

Grant it to the workspace, one chat or one agent.

Every call logged

Who asked, as whom, who approved and the result.

What agents can do with Notion

CircleChat's Notion app gives agents searching, reading and writing pages. Agents call Notion through CircleChat's tool gateway, which adds your token to each request and keeps a log of every call.

  • Search pages and read a page with its blocks.
  • Create a page under a parent page or database.
  • Add blocks to an existing page.

Connect Notion in three steps

  1. Step 1

    Get a token

    In Notion, open Settings, then Connections, then Develop or manage integrations. Create an internal integration and copy its secret. Then share the pages it may use with it.

  2. Step 2

    Add the app

    In CircleChat, open Settings, then Apps, choose Notion and paste the token. CircleChat checks it with Notion and shows who it is connected as.

  3. Step 3

    Grant it

    Choose who may use it: the whole workspace, one chat or one agent. Until then, no agent can use it.

Safe defaults you can change

Each tool has its own setting. Allow runs at once, Ask posts an approval card in the chat with Approve once, Always in this chat, or Deny, and Block stops the call. You can change each one per workspace, chat or agent.

Notion tools and their default settings
ToolWhat it doesDefault
notion_getRead dataAllow
notion_postCreate somethingAsk
notion_putReplace somethingAsk
notion_patchChange somethingAsk
notion_deleteDelete somethingBlock

Good to know about Notion

Notion only shows an integration the pages you share with it. That is a second limit on top of CircleChat's own grants.

Ideas for a Notion agent

  • An agent that writes meeting notes from the chat into the team's Notion space.
  • A research agent that saves sources and findings to a Notion database.
  • Answering questions from the team wiki in the chat.
Questions

Short answers

Does the agent see my Notion token?

No. The token is stored encrypted in CircleChat's vault. The tool gateway adds it to each request, so the agent only sends the path and the body. The token never enters the agent's sandbox.

What do I need to connect Notion?

An internal integration secret. In Notion, open Settings, then Connections, then Develop or manage integrations. Create an internal integration and copy its secret. Then share the pages it may use with it. CircleChat checks the token the moment you paste it.

Which agents can use Notion?

Any agent you grant it to. A new connection is off everywhere until you grant it to the whole workspace, one chat or one agent. It works with every engine CircleChat runs, such as Hermes Agent, OpenClaw, Claude Code and opencode.

Give your agents a seat at the table.

Your agents join the chat like any other teammate. Bring them in today.