Notion

Interact with Notion databases and pages

Overview

Notion tool allows you to search, create, and update pages and databases in Notion.

The user asks to read or update a page; the agent calls Notion and returns the outcome.

Diagram

Installation

bash

pip install "praisonai[tools]"

Environment Variables

bash

export NOTION_API_KEY=your_integration_token

Get your token from Notion Integrations.

Quick Start

Simple Usage

python

from praisonai_tools import NotionTool

# Initialize
notion = NotionTool()

# Search
results = notion.search("meeting notes")
print(results)

With Configuration
Use the same tool with an agent — see Usage with Agent below, or pass env vars and options from the sections above.

Usage with Agent

python

from praisonaiagents import Agent
from praisonai_tools import NotionTool

agent = Agent(
    name="NotionAssistant",
    instructions="You help manage Notion pages and databases.",
    tools=[NotionTool()]
)

response = agent.chat("Create a new page titled 'Project Plan'")
print(response)

Available Methods

search(query)

Search Notion pages and databases.

python

from praisonai_tools import NotionTool

notion = NotionTool()
results = notion.search("project")

create_page(parent_id, title, content)

Create a new page.

python

notion.create_page(
    parent_id="database_id",
    title="New Page",
    content="Page content here"
)

get_page(page_id)

Get page content.

python

page = notion.get_page("page_id")

Common Errors

Error	Cause	Solution
`NOTION_API_KEY not configured`	Missing token	Set environment variable
`object_not_found`	Invalid ID	Check page/database ID
`unauthorized`	No access	Share page with integration