> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Notion

**Authentication:** OAuth or integration token. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app.

## Sample use cases

* Search the `Engineering Wiki` for pages last edited over 60 days ago and tagged `runbook` for archive review.
* Add a new entry to the `Decisions Log` database with today's architecture decision.
* Find every page in `Product / Specs` blocked on review and DM the reviewer.

## Available Tools

#### append\_block\_children

Append child blocks to a parent block. CRITICAL: children parameter must be native JSON array of block objects, NOT strings. Use \[\{"object": "block", "type": "paragraph", ...}] format.

#### get\_block

Retrieve a block by ID

#### get\_block\_children

Retrieve children of a block with pagination

#### update\_block

Update a block's content or properties. CRITICAL: All block properties must be native JSON objects, NOT strings. Use proper block type structure.

#### delete\_block

Delete a block

#### create\_comment

Create a comment on a page or block

#### list\_comments

List comments for a block or get ALL comments from an entire page

#### create\_database

Create a new database in Notion with specified schema, properties, and parent page. Requires properly structured parent object with type field and valid page\_id.

#### query\_database

Query a database with filtering, sorting, and pagination.

#### get\_database

Retrieve a database by ID

#### update\_database

Update database properties, title, description, icon, cover, and schema

#### create\_page

Create a new page in Notion under an existing page or database.

#### get\_page

Retrieve a page by ID

#### get\_page\_property

Retrieve a specific page property

#### update\_page

Update page properties, icon, cover, or archive status

#### archive\_page

Archive a page (move to trash)

#### search

Search for pages and databases by title

#### list\_users

List all users in the workspace

#### get\_user

Retrieve a user by ID

#### get\_bot\_user

Retrieve the current integration's bot user