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

# Notion Integration

> Connect Notion to ZeroTwo to manage your workspace, databases, and pages with AI assistance

The Notion integration enables ZeroTwo to interact with your Notion workspace through the Model Context Protocol (MCP), allowing you to search, create, and update pages and databases using natural language.

## What you can do

<CardGroup cols={2}>
  <Card title="Search content" icon="magnifying-glass">
    Find pages, databases, and blocks across your Notion workspace
  </Card>

  <Card title="Read pages" icon="file-lines">
    Access and analyze content from Notion pages
  </Card>

  <Card title="Create pages" icon="file-plus">
    Generate new pages with AI-written content
  </Card>

  <Card title="Manage databases" icon="database">
    Query, add, and update database entries
  </Card>
</CardGroup>

## Connecting Notion

<Steps>
  <Step title="Open integrations">
    Navigate to Settings → Integrations → Notion
  </Step>

  <Step title="Authorize with Notion">
    Click "Connect" and sign in to your Notion account.

    **Permissions requested:**

    * Read content from your workspace
    * Create and update pages
    * Access databases
    * Manage blocks and content
  </Step>

  <Step title="Select workspaces">
    Choose which Notion workspaces to connect.
  </Step>

  <Step title="Confirm">
    <Check>
      Notion integration is now active via MCP.
    </Check>
  </Step>
</Steps>

<Info>
  This integration uses the Model Context Protocol (MCP) for secure, standardized access to your Notion workspace. Learn more about [MCP integrations](/integrations/mcp-overview).
</Info>

## Using Notion with AI

### Searching Notion

<CodeGroup>
  ```text Page search theme={null}
  "Find my Notion page about project planning"
  "Search for pages with 'Q4 goals'"
  "Show me recent pages I created"
  ```

  ```text Database queries theme={null}
  "Query the Tasks database for incomplete items"
  "Show entries in the Contacts database from last month"
  "Find all database items assigned to me"
  ```

  ```text Content search theme={null}
  "Search Notion for mentions of 'budget review'"
  "Find pages containing the word 'deadline'"
  ```
</CodeGroup>

### Reading and analyzing

```text theme={null}
"Summarize the content of my 'Product Roadmap' page"
"Read the meeting notes from yesterday"
"What are the tasks in my project tracker?"
"Extract action items from the team retrospective page"
```

### Creating content

<Tabs>
  <Tab title="New pages">
    ```text theme={null}
    "Create a Notion page with an outline for the marketing plan"
    "Make a new meeting notes page for today's standup"
    "Generate a project kickoff document in Notion"
    ```
  </Tab>

  <Tab title="Database entries">
    ```text theme={null}
    "Add a task to my Notion Tasks database: Review Q4 budget"
    "Create a new contact entry for Alice Johnson"
    "Add a project to the Projects database with due date next month"
    ```
  </Tab>

  <Tab title="Structured content">
    ```text theme={null}
    "Create a page with sections for Goals, Timeline, and Resources"
    "Make a meeting agenda page with talking points and action items"
    ```
  </Tab>
</Tabs>

### Updating content

```text theme={null}
"Update the status of the 'Website Redesign' project to In Progress"
"Add a section to my meeting notes about the new deadline"
"Mark task #123 as complete in the Tasks database"
```

## Notion databases

### Querying databases

```text theme={null}
"Show all tasks with status 'In Progress'"
"List projects with deadlines this month"
"Find contacts tagged as 'clients'"
```

### Adding entries

```text theme={null}
"Add a task: Complete documentation, Due: Friday, Priority: High"
"Create a new project entry with name 'Website Refresh' and status 'Planning'"
```

### Updating records

```text theme={null}
"Change the status of task 'API Implementation' to 'Done'"
"Update project deadline to next Tuesday"
"Add tag 'urgent' to the client onboarding task"
```

## Advanced features

### Templates

```text theme={null}
"Create a meeting notes page from my template"
"Use the project kickoff template to start a new project"
```

### Cross-workspace operations

```text theme={null}
"Search for 'roadmap' across all my connected Notion workspaces"
"Create a page in the Marketing workspace"
```

### Bulk operations

```text theme={null}
"Find all incomplete tasks and create a summary"
"Export all pages tagged 'archived' as markdown"
```

## Privacy and permissions

<Info>
  **Access scope:**

  * Only workspaces and pages you explicitly grant access to
  * Notion content processed only for your queries
  * No data stored permanently on ZeroTwo servers
  * Revoke access anytime through Notion settings

  **MCP security:**

  * Secure token-based authentication
  * Granular permission controls
  * Audit logs of integration actions
</Info>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Can't find pages">
    **Solutions:**

    * Ensure the page is in a connected workspace
    * Check page isn't in trash
    * Verify you have access permissions to the page
    * Try searching with exact page title
  </Accordion>

  <Accordion title="Permission errors">
    **Solutions:**

    * Reconnect Notion integration with full permissions
    * Check integration settings in Notion workspace
    * Verify you're a workspace admin or have edit permissions
    * Ensure MCP connection is active
  </Accordion>

  <Accordion title="Database operations failing">
    **Solutions:**

    * Confirm database has required fields
    * Check property types match the data you're adding
    * Verify database permissions allow editing
    * Ensure all required fields are provided
  </Accordion>
</AccordionGroup>

## Use cases

### Knowledge management

```text theme={null}
"Search my Notion for all documentation about the API"
"Create a new knowledge base entry about deployment process"
```

### Project tracking

```text theme={null}
"Show me all active projects and their current status"
"Update project timelines based on recent changes"
```

### Meeting notes

```text theme={null}
"Create meeting notes for today's team sync and add action items"
"Find all meeting notes from last month and summarize key decisions"
```

### Task management

```text theme={null}
"What tasks are due this week?"
"Create a task list for the new project launch"
```

## Related integrations

<CardGroup cols={2}>
  <Card title="MCP overview" icon="plug" href="/integrations/mcp-overview">
    Learn about Model Context Protocol
  </Card>

  <Card title="Linear" icon="diagram-project" href="/integrations/linear">
    Project management integration
  </Card>

  <Card title="GitHub" icon="github" href="/integrations/github">
    Code repository integration
  </Card>

  <Card title="All integrations" icon="grid" href="/integrations">
    Browse all integrations
  </Card>
</CardGroup>