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

# Notion Integration

> Automatically push meeting notes, summaries, and action items to your Notion workspace.

Connect Mavio to Notion to automatically create pages with meeting summaries, action items, and transcript highlights in your Notion workspace. Build a searchable knowledge base of every meeting your team has.

## Setting up the Notion integration

<Steps>
  <Step title="Connect Notion">
    Go to **Settings > Integrations > Notion** and click **Connect Notion**. You will be redirected to Notion's authorization page.
  </Step>

  <Step title="Select pages and databases">
    Notion will ask you to select which pages or databases Mavio can access. Choose the database where you want meeting notes to appear, or select a parent page for Mavio to create content under.
  </Step>

  <Step title="Authorize access">
    Click **Allow access** to complete the connection.
  </Step>

  <Step title="Map fields">
    Mavio presents a field mapping screen:

    * Choose the target **database** (or let Mavio create a new "Meeting Notes" database)
    * Map fields: meeting title, date, attendees, summary, action items, recording link
    * Click **Save**.
  </Step>
</Steps>

<Tip>
  Let Mavio create a dedicated "Meeting Notes" database for you. It comes pre-configured with the right properties (date, attendees, tags, status) and views (by date, by participant, by tag).
</Tip>

## What Mavio creates in Notion

After each meeting, Mavio creates a new page in your Notion database containing:

| Section            | Content                                                        |
| ------------------ | -------------------------------------------------------------- |
| **Page title**     | Meeting name and date                                          |
| **Properties**     | Date, attendees, duration, recording method, tags              |
| **Summary**        | AI-generated meeting summary with key topics                   |
| **Decisions**      | Specific decisions made during the meeting                     |
| **Action items**   | Tasks with assignees, formatted as a to-do list                |
| **Highlights**     | Notable quotes and important statements                        |
| **Recording link** | Direct link back to the full recording and transcript in Mavio |

The page is formatted with Notion-native blocks (headings, toggles, to-do items, callouts) for a clean reading experience.

## Automatic vs. manual sync

### Automatic sync

When enabled, Mavio creates a Notion page after every recorded meeting. Configure this in **Settings > Integrations > Notion > Auto-sync**:

* **All meetings** — every recording creates a Notion page
* **Selected meetings** — only meetings matching your filter rules
* **Team meetings only** — only meetings with 2+ internal participants

### Manual sync

Push any recording to Notion on demand:

1. Open the meeting in Mavio.
2. Click **Share > Send to Notion**.
3. Select the target database and confirm.

## Database views

If you use the Mavio-created database, it includes these pre-built views:

| View               | Shows                                                 |
| ------------------ | ----------------------------------------------------- |
| **Timeline**       | Meetings sorted by date                               |
| **By participant** | Grouped by attendee names                             |
| **Action items**   | Filtered to show only meetings with open action items |
| **This week**      | Meetings from the current week                        |

You can customize these views or create new ones using Notion's standard filtering and sorting.

## Action items as to-dos

Action items are created as Notion to-do blocks within the meeting page. They include:

* Checkbox for completion tracking
* Assignee mention (if the Notion user matches the meeting participant)
* Due date (if mentioned in the meeting)
* Context snippet from the transcript

Check off action items in Notion — the status syncs back to Mavio so your action items stay consistent across both platforms.

<Note>
  Two-way sync of action item status requires both the Mavio and Notion integrations to be active. If you disconnect the integration, status changes will no longer propagate.
</Note>

## Customizing the page template

Adjust what appears in your Notion meeting pages:

1. Go to **Settings > Integrations > Notion > Page template**.
2. Toggle sections on or off: summary, decisions, action items, highlights, full transcript.
3. Reorder sections by dragging.
4. Add custom sections with static text (e.g., a "Follow-up needed" prompt).

## Troubleshooting

<AccordionGroup>
  <Accordion title="Pages are not being created">
    Verify the Notion integration is connected and the target database is accessible. In Notion, check that the Mavio integration has access to the database (**Share > Connections > Mavio**).
  </Accordion>

  <Accordion title="Properties are missing from the database">
    Mavio creates properties on the first sync. If you removed a property, Mavio will attempt to recreate it on the next sync. You can also remap fields in **Settings > Integrations > Notion > Field mapping**.
  </Accordion>

  <Accordion title="Attendee mentions are not working">
    Notion user mentions require the participant's email to match a Notion workspace member. If the email does not match, the attendee appears as plain text instead of a mention.
  </Accordion>
</AccordionGroup>