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

# Notion

> Connect Notion to your Macaly account

Notion is an all-in-one workspace for notes, docs, wikis, and databases that teams use to organize their work. Connect your account once and the agent can turn your pages and databases into real content in your project, or keep them updated automatically.

<Callout icon="user">
  Available on all plans
</Callout>

## Why connect Notion

* **Turn a Notion database into your website's content.** Write blog posts, changelog entries, or docs in Notion, and the agent pulls them straight into your project as real pages.
* **Turn leads into database rows automatically.** When someone submits a form on your site, the agent adds them as a row in your Notion database, ready for your team to follow up.
* **Edit pages and databases from the chat.** Create a page, add a row, or search your workspace without opening Notion.

## What you need

* A **Notion account**. Create one for free at [notion.so](https://notion.so)
* The pages or databases you want the agent to use, shared with the connection

## Connect Notion to Macaly

<Steps>
  <Step title="Open Settings">
    Go to **Settings → Integrations** in your Macaly workspace.
  </Step>

  <Step title="Connect Notion">
    Find the Notion card in the list of apps and click the **Connect** button.
  </Step>

  <Step title="Authorize your account">
    A new window opens, where you'll be asked to sign in to Notion. Once you approve access, you'll be redirected back to Macaly.
  </Step>
</Steps>

## Use Notion from the chat

Once connected, describe what you want and the agent handles the rest.

Turn your database into site content:

```
Build a blog where each post is pulled from my "Blog" Notion
database, rendered as a page on my site.
```

Turn leads into database rows automatically:

```
Add a row to my "Leads" Notion database for Acme Corp, set the
status to "New", and assign it to me.
```

Edit pages directly:

```
Create a Notion page called "Launch plan" under my "Projects" page
with a checklist of the steps we discussed.
```

Or build a changelog from your workspace:

```
I'm building a changelog page. Pull the published entries from my
Notion database and show them newest first.
```

## What the agent can do in Notion

Create and edit pages, work with databases by adding and updating rows and querying with filters and sorting, read pages as Markdown, search your workspace, and archive, duplicate, or move pages to keep things organized.

## Good to know

* **You connect once.** Every project in your workspace reuses the same Notion connection.
* **Share the right pages.** The agent can only see Notion pages and databases you've shared with the connection, so grant access to what you want it to use.
* **Your account, your control.** The agent only acts when you ask it to. You can disconnect Notion anytime from **Settings → Integrations**.