Cevanos

Search the docs

Search the API reference and every integration guide.

Productivity

Notion integration

Connect Notion so your Cevanos agent can search internal notes and read individual pages. You can also select Notion pages as knowledge sources.

Personal access token2 reads, no changes

Overview

Notion lets your agent search internal notes and read individual pages. You can also select Notion pages as knowledge sources.

The integration is read-only: it cannot create, edit or delete Notion content.

The journey at a glance

  1. 1Find NotionOpen Integrations and select Connect.
  2. 2Create and connect a tokenCreate a Notion token and verify it in Cevanos.
  3. 3Limit Notion page accessAllow only approved Notion pages.
  4. 4Choose what it can doChoose Workspace and This agent capabilities.
  5. 5Check the Actions pageConfirm the two read actions are enabled.
  6. 6Use Notion pages as knowledge (optional)Select shared Notion pages in Sources.
  7. 7Verify the connectionSearch a shared page and check restricted pages stay hidden.

Before you start

You need access to the Notion workspace containing your approved pages, permission to create a personal access token and a Cevanos role that manages integrations.

Keep the token out of screenshots

Never include a token in screenshots or shared documents.

Step 1

Find Notion

  1. 1Open your Cevanos agent and go to Deployment → Integrations.
  2. 2Search for Notion under Productivity and click Connect.
Notion integration in the Cevanos catalogue.

Result

The Connect Notion wizard opens.

Step 2

Create and connect a token

2a. Create a personal access token in Notion

  1. 1Open the Notion workspace menu at the lower left. Select Settings.
  2. 2Go to Developer → Personal access tokens → New token.
  3. 3Enter a descriptive token name and check its expiration date. Keep Notion API enabled; Workers is not needed.
  4. 4Click Create token, then Copy and close. Store the token securely.
Notion workspace menu: select Settings.
Notion Developer settings: select New token.
Create the token with Notion API enabled.
Copy the token; its value is hidden in this screenshot.

2b. Connect in Cevanos

  1. 1Return to the Notion connection wizard and click Get started.
  2. 2Paste the token in Internal integration secret.
  3. 3Click Verify & connect.
Cevanos wizard: Get started.
Enter Internal integration secret and verify.

2c. Check the result

A green Connected confirmation means the token was accepted. It does not mean the agent has access to every page or that any read capability is enabled. On reconnect, review any offer to restore old capabilities.

Connected confirmation: choose what the agent can do.

Result

Notion is connected. Restrict page access before enabling customer-facing use.

Step 3

Limit Notion page access

  1. 1In Notion, open Settings → Connections → Connected.
  2. 2Find the Cevanos connection (it may appear as CXOps in older Notion accounts) and select Manage.
  3. 3Select Edit access, choose only approved pages and click Save.
Notion Connections: select Connected.
Find the connection and select Manage.
Choose Edit access.
Choose approved pages and save the access selection.

No page restrictions?

If page restrictions are unavailable for the account or connection, use an account with access only to content intended for the agent.

Step 4

Choose what it can do

  1. 1In Cevanos, open the Notion integration and choose Choose what it can do.
  2. 2For each required read, tick Workspace and This agent.
  3. 3Select Save capabilities.
Enable the allowed Notion reads for Workspace and This agent.

Result

Only selected capabilities become available to the agent.

Step 5

Check the Actions page

  1. 1Open the agent's Actions page.
  2. 2Find Notion under Productivity and check the read switches.
Notion Actions: Search the internal notes and Read one note.

There are two read actions and no write actions, so no write approval setting is needed.

Step 6

Use Notion pages as knowledge (optional)

  1. 1Open Sources → Notion, Drive or Confluence → Notion.
  2. 2Review Pages to read, and deselect anything that should not become a knowledge source.
  3. 3Confirm the page selection to add it.

Same approved pages

Pages shown depend on the access granted to the Notion connection. Keep the Sources selection consistent with the approved pages.

Step 7

Verify the connection

Confirm Connected, then ask the agent to search a page that was explicitly shared with the connection. Check that restricted pages are not exposed.

Reference

What Notion can do

Notion supplies two actions, both reads.

2 capabilities · 2 reads

Reads2

  • Search the internal notes

    Finds page titles from accessible Notion pages.

    notion.search_pages

  • Read one note

    Reads text from an accessible page for the agent's response.

    notion.read_page

Troubleshooting

ProblemWhat to check
Verify & connect failsCheck the token was copied fully, has not expired, and is from the intended workspace.
Connected but no pages foundIn Notion, open Connections → Connected → Manage → Edit access.
An action cannot runEnable Workspace and This agent, then check Actions.
The card says Needs attentionThe token may have expired or been revoked. Create another and reconnect.

Optional

Disconnect Notion

Open the Notion integration in Cevanos and select Disconnect Notion. This stops access for affected agents.

Your data stays

Disconnecting does not delete Notion pages. Revoke the token separately in Notion if necessary.

Ready to connect Notion?

Open your agent's Integrations and click Connect on the Notion card.

Go to dashboard