# Notion Integration

Give your AI agent the ability to search, read, create, and update pages and databases in Notion.

---

Connect Notion to your Chipp AI so it can search your workspace, read page content, query databases, and create or update pages -- all through natural conversation.

## What the AI Can Do

Once connected, your agent gains five tools:

| Tool | Description |
|------|-------------|
| **notion_search** | Search for pages and databases across the workspace |
| **notion_get_page** | Read a page's properties and content blocks |
| **notion_query_database** | Query a Notion database with filters and sorts |
| **notion_create_page** | Create a new page under a parent page or database |
| **notion_update_page** | Update page properties or archive a page |

### Content Support

The integration reads and renders Notion's block types as readable text:

- Paragraphs, headings (H1, H2, H3)
- Bulleted and numbered lists
- To-do items (with checkbox state)
- Code blocks (with language)
- Quotes and callouts
- Toggles and dividers
- Images (as links)

### Property Types

Database queries return all standard Notion property types:

- Title, rich text, number, select, multi-select
- Date, checkbox, URL, email, phone number
- Status, people, relation

## Connecting Notion


  **1.** 
    <strong>Open the Integrations tab</strong>

    In your app's builder, navigate to the **Build** section and select the **Integrations** tab. Find **Notion** in the list of available integrations.
  


  **2.** 
    <strong>Click Connect</strong>

    Click the **Connect** button next to Notion. You will be redirected to Notion's authorization page.
  


  **3.** 
    <strong>Select pages to share</strong>

    Notion uses a permission model where you explicitly choose which pages and databases the integration can access. Select the pages you want your AI to work with.

    > **Note:** The integration can only access pages you explicitly share during authorization. To add more pages later, reconnect the integration and select additional pages.
  


  **4.** 
    <strong>Test it out</strong>

    Once connected, open the chat preview and try:
    - "Search my Notion for meeting notes"
    - "Show me the tasks database"
    - "Create a new page called 'Weekly Summary' with a list of accomplishments"
  


## Working with Databases

Notion databases are a powerful feature, and the agent can interact with them directly:

### Querying

The agent can query databases with filters and sorting:
- "Show me all tasks with status 'In Progress'"
- "List contacts sorted by last modified date"
- "Find all projects assigned to the marketing team"

### Creating Rows

The agent can add new entries to databases:
- "Add a new task called 'Review proposal' to the Tasks database"
- "Create a new contact entry for Sarah at Acme Corp"

### Updating

The agent can update existing page properties:
- "Mark the 'Review proposal' task as complete"
- "Update the project deadline to next Friday"
- "Archive the old meeting notes page"

## Example Use Cases

- **Knowledge base assistant** -- Search and retrieve information from a Notion wiki
- **Task management** -- Query, create, and update tasks in a Notion database
- **Meeting notes** -- "Create a page for today's standup with attendees and action items"
- **CRM** -- Track contacts and deals in a Notion database through conversation
- **Content planning** -- "Show me all blog posts in draft status and their due dates"
- **Documentation search** -- "Find our API documentation for the authentication flow"

## Billing

Notion tool calls use your standard LLM token billing. There is no separate per-call fee. Reading pages with large content blocks consumes more tokens.