Skip to main content

​
Notion

Search pages, read content, create new pages, and query databases in Notion.

​
Quick Start

import { Agent, openai, NotionToolkit } from "@radaros/core";

const notion = new NotionToolkit();
// Uses NOTION_API_KEY env var

const agent = new Agent({
  name: "notion-assistant",
  model: openai("gpt-4o"),
  instructions: "Help manage Notion pages and databases.",
  tools: [...notion.getTools()],
});

const result = await agent.run("Search for meeting notes from last week");

​
Config

​
token
string
Notion internal integration token. Falls back to NOTION_API_KEY env var.

​
Tools

ToolDescription
notion_searchSearch Notion for pages and databases by title/content.
notion_get_pageGet content of a page by ID (returns text blocks).
notion_create_pageCreate a page in a database or as a child of a page.
notion_query_databaseQuery a database with optional Notion filters.

​
Setup

  1. Create an internal integration
  2. Copy the integration token
  3. Share your pages/databases with the integration (click ”…” > “Connections” > add your integration)

​
Environment Variables

export NOTION_API_KEY="ntn_..."