> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agno.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Notion Tools

> The NotionTools toolkit enables Agents to interact with your Notion pages.

<Badge icon="code-branch" color="orange">
  <Tooltip tip="Introduced in v2.2.6" cta="View release notes" href="https://github.com/agno-agi/agno/releases/tag/v2.2.6">v2.2.6</Tooltip>
</Badge>

Notion is a workspace management tool for creating, organizing, and collaborating on your work.

Agno provides tools for interacting with Notion databases to help you automate your workflows and streamline your work.

## Prerequisites

To use `NotionTools`, you need to install the `notion-client` and `openai` libraries:

```shell theme={null}
uv pip install notion-client openai
```

### Step 1: Create a Notion Integration

1. Go to [https://www.notion.so/my-integrations](https://www.notion.so/my-integrations)
2. Click on **"+ New integration"**
3. Fill in the details:
   * **Name**: Give it a name like "Agno Query Classifier"
   * **Associated workspace**: Select your workspace
   * **Type**: Internal integration
4. Click **"Submit"**
5. Copy the **"Internal Integration Token"** (starts with `secret_`)
   * ⚠️ Keep this secret! This is your `NOTION_API_KEY`

### Step 2: Create a Notion Database

1. Open Notion and create a new page
2. Add a **Database** (you can use "/database" command)
3. Set up the database with these properties:
   * **Name** (Title) - Already exists by default
   * **Tag** (Select) - Click "+" to add a new property
     * Property type: **Select**
     * Property name: **Tag**
     * Add these options:
       * travel
       * tech
       * general-blogs
       * fashion
       * documents

### Step 3: Share Database with Your Integration

1. Open your database page in Notion
2. Click the **"..."** (three dots) menu in the top right
3. Scroll down and click **"Add connections"**
4. Search for your integration name (e.g., "Agno Query Classifier")
5. Click on it to grant access

### Step 4: Get Your Database ID

Your database ID is in the URL of your database page:

```
https://www.notion.so/../{database_id}?v={view_id}
```

The `database_id` is the 32-character string (with hyphens) between the workspace name and the `?v=`.

Example:

```
https://www.notion.so/myworkspace/28fee27fd9128039b3f8f47cb7ade7cb?v=...
                                 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
                                 This is your database_id
```

Copy this database ID.

```shell theme={null}
export NOTION_API_KEY=your_api_key_here
export NOTION_DATABASE_ID=your_database_id_here
```

## Example

The following example demonstrates how to use `NotionTools` to create, update and search for Notion pages with specific tags.

```python theme={null}
from agno.agent import Agent
from agno.tools.notion import NotionTools

# Create an agent with Notion Tools
notion_agent = Agent(
    name="Notion Knowledge Manager",
    instructions=[
        "You are a smart assistant that helps organize information in Notion.",
        "When given content, analyze it and categorize it appropriately.",
        "Available categories: travel, tech, general-blogs, fashion, documents",
        "Always search first to avoid duplicate pages with the same tag.",
        "Be concise and helpful in your responses.",
    ],
    tools=[NotionTools()],
    markdown=True,
)

def demonstrate_tools():
    print("  Notion Tools Demonstration\n")
    print("=" * 60)

    # Example 1: Travel Notes
    print("\n Example 1: Organizing Travel Information")
    print("-" * 60)
    prompt = """
    I found this amazing travel guide: 
    'Ha Giang Loop in Vietnam - 4 day motorcycle adventure through stunning mountains.
    Best time to visit: October to March. Must-see spots include Ma Pi Leng Pass.'
    
    Save this to Notion under the travel category.
    """
    notion_agent.print_response(prompt)

    # Example 2: Tech Bookmarks
    print("\n Example 2: Saving Tech Articles")
    print("-" * 60)
    prompt = """
    Save this tech article to Notion:
    'The Rise of AI Agents in 2025 - How autonomous agents are revolutionizing software development.
    Key trends include multi-agent systems, agentic workflows, and AI-powered automation.'
    
    Categorize this appropriately and add to Notion.
    """
    notion_agent.print_response(prompt)

    # Example 3: Multiple Items
    print("\n Example 3: Batch Processing Multiple Items")
    print("-" * 60)
    prompt = """
    I need to save these items to Notion:
    1. 'Best fashion trends for spring 2025 - Sustainable fabrics and minimalist designs'
    2. 'My updated resume and cover letter for job applications'
    3. 'Quick thoughts on productivity hacks for remote work'
    
    Process each one and save them to the appropriate categories.
    """
    notion_agent.print_response(prompt)

    # Example 4: Search and Update
    print("\n🔍 Example 4: Finding and Updating Existing Content")
    print("-" * 60)
    prompt = """
    Search for any pages tagged 'tech' and let me know what you find.
    Then add this new insight to one of them:
    'Update: AI agents now support structured output with Pydantic models for better type safety.'
    """
    notion_agent.print_response(prompt)

    # Example 5: Smart Categorization
    print("\n Example 5: Automatic Smart Categorization")
    print("-" * 60)
    prompt = """
    I have this content but I'm not sure where it belongs:
    'Exploring the ancient temples of Angkor Wat in Cambodia. The sunrise view from Angkor Wat 
    is breathtaking. Best visited during the dry season from November to March.'
    
    Analyze this content, decide the best category, and save it to Notion.
    """
    notion_agent.print_response(prompt)

    print("\n" + "=" * 60)
    print(
        "\nYour Notion database now contains organized content across different categories."
    )
    print("Check your Notion workspace to see the results!")

if __name__ == "__main__":
    demonstrate_tools()
```

## Toolkit Functions

These are the functions exposed by `NotionTools`:

| Function                           | Description                                                               |
| ---------------------------------- | ------------------------------------------------------------------------- |
| `create_page(title, tag, content)` | Creates a new page in the Notion database with a title, tag, and content. |
| `update_page(page_id, content)`    | Adds content to an existing Notion page by appending a new paragraph.     |
| `search_pages(tag)`                | Searches for pages in the database by tag and returns matching results.   |

## Toolkit Params

These parameters are passed to the `NotionTools` constructor:

| Parameter             | Type            | Default | Description                                                                             |
| --------------------- | --------------- | ------- | --------------------------------------------------------------------------------------- |
| `api_key`             | `Optional[str]` | `None`  | Notion API key (integration token). Uses `NOTION_API_KEY` env var if not provided.      |
| `database_id`         | `Optional[str]` | `None`  | The ID of the database to work with. Uses `NOTION_DATABASE_ID` env var if not provided. |
| `enable_create_page`  | `bool`          | `True`  | Enable the create\_page tool.                                                           |
| `enable_update_page`  | `bool`          | `True`  | Enable the update\_page tool.                                                           |
| `enable_search_pages` | `bool`          | `True`  | Enable the search\_pages tool.                                                          |
| `all`                 | `bool`          | `False` | Enable all tools. Overrides individual enable flags when `True`.                        |

## Developer Resources

* [Tools](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/tools/notion.py)