For the complete documentation index, see llms.txt. This page is also available as Markdown.

Notion Integration

Search, create, and manage your Notion pages and databases through Frevana, Setup time: 2 minutes · Cost: Free · No coding required

FrevanaSetup time: 2 minutes · Cost: Free · No coding required


1

Go to notion.so/my-integrations

Sign in, and Click "Create a new integration"

If your account belongs to an organization, you might not have sufficient permission to create integrations.

2

Enter the basic information

  • Enter the Integration name, Icon, and Associated workspace, and Click "Create" button;

  • Click the "Configure integration settings" button, you will be directed to the Edit integration Page

3

Copy the "Notion Secret Token"

You'll see your Internal Integration Secret — it starts with ntn_ , Click the Show Button next to the token, this is the Notion Secret Token you will need for the Agent team.

Keep this token safe. Anyone with this token can access the pages you share with the integration. If you lose it, you can always come back to this page to view or refresh it.

4

Edit Content Access

Add Pages and Databases access to the integration

  • Go to Content access tab

  • Click "Edit access",

  • Select the pages and databases you want the AI to access

  • Click Save

Tip: If you want the AI to access your entire workspace, just select all pages. You can always come back and change this later.

5

Paste the Notion Secret Token into the Agent team Chat

Open the Notion Agent team Chat Window and just start using it, for example:

List my Notion databases

If the AI detects that Notion isn't connected yet, it will ask you to paste your Notion Secret Token (the ntn_... token) from Step 4 above.

and the AI will:

1. Verify the token works

2. Show you which workspace it connected to

3. Start working immediately

That's it — you're connected! 🎉


What You Can Do

Action
Example

Search

"Find my pages about product roadmap"

Read

"Show me the content of my project brief"

Create

"Create a new page with today's meeting notes"

Update

"Rename that page to Q2 Review"

Append

"Add action items to yesterday's meeting page"

List databases

"Show me all my Notion databases"

Query database

"Show tasks due this week from my Tasks board"

Add entry

"Add a new task called 'Review PR' with status 'To Do'"

View schema

"What properties does my Projects database have?"


Troubleshooting

"Not found" or "Object not found"

The page or database isn't shared with your integration.

Fix: Open the page in Notion → click ···Connections → add your integration name.

"Invalid token"

The token was copied incorrectly or has expired.

Fix: Go to notion.so/my-integrations, click on your integration, and copy the token again. It should start with ntn_.

"Can't see my databases" or search returns nothing

Databases and pages must be explicitly shared with the integration.

Fix: Open each top-level page in your sidebar → ···Connections → add your integration. Remember, sharing a parent page shares all its children too.

Query returns empty results

Property names in filters are case-sensitive and must match exactly.

Fix: Ask the AI "Show me the schema of my [database name] database" first to see the exact property names and types. Then try your query again using those exact names.

Want to disconnect or change workspaces?

Tell the AI "Reconnect my Notion" and paste a new token. The old token is replaced automatically.


Privacy & Security

  • Your token is stored only on your computer (~/.config/notion/config.json)

  • The AI accesses Notion through the official API — your data is not stored or sent anywhere else

  • The integration can only see pages you've explicitly shared with it

  • You can revoke access anytime by deleting the integration at notion.so/my-integrations

Last updated