Skip to main content

​
Overview

OneCLI connects AI agents to Notion through Notion’s OAuth flow. Agents can search your workspace, read page content, create and update pages, and query databases. The gateway injects OAuth credentials into requests to the Notion API automatically. This is useful for agents that need to look up internal documentation, create tasks or notes, or sync data with Notion databases.

​
Setup

1

Go to Connections

Open the OneCLI dashboard and navigate to Connections > Notion.
2

Authorize

Click Connect Notion. You’ll be redirected to Notion to authorize OneCLI. Select which pages and databases the integration can access, then click Allow access.

​
What agents can do

  • Search across all accessible pages and databases by keyword
  • Read the full content of a page (text, headings, lists, tables, callouts)
  • Create new pages in a specified parent page or database
  • Update existing page content (append blocks, modify properties)
  • Query databases with filters and sorts (e.g., all tasks with status “In Progress”)
  • Create new entries in a database with specified property values
  • Update database entry properties (status, assignee, dates, tags)
  • Read database schema (property names, types, select options)
  • Archive and restore pages
  • Read and add comments on a page

​
Controlling access

Access is per agent: grant the connection to each agent that needs it, choosing per tool what runs freely, what needs human approval, and what stays blocked — a read-only agent is a single grant. Organization rules add guardrails on top, like rate limits and blanket blocks. Everything is checked before credential injection, so a blocked request never reaches Notion.