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

# Using BulkNotion from Claude

> Use this to connect BulkNotion to Claude so you can run bulk updates by asking for them.

BulkNotion has an MCP connector. Connect it once and you can run bulk updates in
conversation — Claude reads your databases, proposes the conditions, shows you the
count and the cost, and waits for your yes.

## The connector URL

```
https://bulknotion.com/api/user/mcp
```

## Connecting Claude

<Steps>
  <Step title="Open the connector settings">
    In Claude, go to **Settings → Connectors** and choose **Add custom
    connector**.
  </Step>

  <Step title="Paste the URL">
    Use the URL above and confirm.
  </Step>

  <Step title="Sign in and approve">
    Sign in with the same Google account you use for BulkNotion, then approve the
    access request. Claude will show BulkNotion's tools in your chats from then
    on.
  </Step>
</Steps>

<Note>
  The connector acts as **your** account only. It sees your workspaces, your
  credits and your jobs — never anyone else's.
</Note>

## Asking for a bulk update

Pick the **Bulk update Notion pages** prompt and Claude runs the whole sequence:
finds the database, tells you what is in it, proposes conditions, shows the count
and cost, and waits for you before starting.

Or just say what you want:

> Apply my Weekly Review template to everything in Content Calendar that is still
> Not started.

Either way you get the numbers before anything happens.

## What you can ask for

|                   |                                                         |
| ----------------- | ------------------------------------------------------- |
| **Check credits** | "How many pages do I have left this month?"             |
| **Explore**       | "What can I filter on in my Content Calendar database?" |
| **Preview**       | "How many pages are still Not started?"                 |
| **Run**           | "Apply the Weekly Review template to those."            |
| **Follow up**     | "Is that finished yet?"                                 |

<Card title="All nine tools" icon="wrench" href="/mcp/tools">
  What each one does, and which are read-only.
</Card>

## Before you run anything

<Warning>
  Bulk updates started from Claude spend credits, the same as from the console.

  They behave differently in one way: Claude **adds the template to a page and
  keeps what was already there**, where the console clears the page first. Read
  [what to watch for](/mcp/safety) before your first run — it is short.
</Warning>

## Other MCP clients

The URL works with any client that supports remote MCP servers over OAuth. Add it
as a custom or remote server and sign in the same way; the tools are identical.

## If Claude cannot see the tools

Reconnect the connector. MCP clients cache the tool list, so one connected before
an update may be working from a stale copy.