Notion

Service domainDOCUMENTS

Arcade Optimized

Arcade.dev LLM tools for Notion

Author:Arcade

Version:1.3.2

Auth:User authorization via the Notion auth provider

8tools

NotionToolkit is a powerful set of tools from Arcade.dev that facilitates interaction with Notion's API, enabling developers to easily manage and manipulate their Notion workspaces. It streamlines operations such as creating pages, appending content, and retrieving metadata or content from existing Notion pages.

Capabilities

Effortlessly create and modify pages within Notion.
Access detailed metadata and content from various Notion objects.
Search and navigate workspace structures and content efficiently.
Retrieve user information and workspace statistics.

OAuth

Provider: Notion
Scopes: None

Available tools(8)

8 of 8 tools

Operations

Behavior

	Tool name	Description	Secrets
	NotionToolkit.AppendContentToEndOfPage	Append markdown content to the end of a Notion page by its ID or title
	NotionToolkit.CreatePage	Create a new Notion page by the title of the new page's parent.
	NotionToolkit.GetObjectMetadata	Get the metadata of a Notion object (page or database) from its title or ID. One of `object_title` or `object_id` MUST be provided, but both cannot be provided. The title is case-insensitive and outer whitespace is ignored. An object's metadata includes it's id, various timestamps, properties, url, and more.
	NotionToolkit.GetPageContentById	Get the content of a Notion page as markdown with the page's ID
	NotionToolkit.GetPageContentByTitle	Get the content of a Notion page as markdown with the page's title
	NotionToolkit.GetWorkspaceStructure	Get the workspace structure of the user's Notion workspace. Ideal for finding where an object is located in the workspace.
	NotionToolkit.SearchByTitle	Search for similar titles of pages, databases, or both within the user's workspace. Does not include content.
	NotionToolkit.WhoAmI	Get information about the current user and their Notion workspace. This tool provides detailed information about the authenticated user's Notion workspace including workspace statistics, user context, and integration details.

Selected tools

No tools selected.

Click "Show all tools" to add tools.

Requirements

Select tools to see requirements

NotionToolkit.AppendContentToEndOfPage

Add to selected tools(no auth required)

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations

Update

Service domains

Documents

MCP behavior

Read only

Does not modify remote state.

Destructive

May delete or overwrite remote data.

Idempotent

Safe to retry without extra side effects.

Open world

Yes

Can call out to external systems.

Append markdown content to the end of a Notion page by its ID or title

Parameters

Parameter	Type	Req.	Description
`page_id_or_title`	`string`	Required	ID or title of the page to append content to
`content`	`string`	Required	The markdown content to append to the end of the page

Requirements

No secrets required

Output

Type:json— A dictionary containing a success message and the URL to the page

NotionToolkit.CreatePage

Add to selected tools(no auth required)

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations

Create

Service domains

Documents

MCP behavior

Read only

Does not modify remote state.

Destructive

May delete or overwrite remote data.

Idempotent

Safe to retry without extra side effects.

Open world

Yes

Can call out to external systems.

Create a new Notion page by the title of the new page's parent.

Parameters

Parameter	Type	Req.	Description
`parent_title`	`string`	Required	Title of an existing page/database within which the new page will be created.
`title`	`string`	Required	Title of the new page
`content`	`string`	Optional	The content of the new page

Requirements

No secrets required

Output

Type:string— The ID of the new page

NotionToolkit.GetObjectMetadata

Add to selected tools(no auth required)

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations

Read

Service domains

Documents

MCP behavior

Read only

Yes

Does not modify remote state.

Destructive

May delete or overwrite remote data.

Idempotent

Yes

Safe to retry without extra side effects.

Open world

Yes

Can call out to external systems.

Get the metadata of a Notion object (page or database) from its title or ID. One of `object_title` or `object_id` MUST be provided, but both cannot be provided. The title is case-insensitive and outer whitespace is ignored. An object's metadata includes it's id, various timestamps, properties, url, and more.

Parameters

Parameter	Type	Req.	Description
`object_title`	`string`	Optional	Title of the page or database whose metadata to get
`object_id`	`string`	Optional	ID of the page or database whose metadata to get
`object_type`	`string`	Optional	The type of object to match title to. Only used if `object_title` is provided. Defaults to both `pagedatabase`

Requirements

No secrets required

Output

Type:json— The metadata of the object

NotionToolkit.GetPageContentById

Add to selected tools(no auth required)

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations

Read

Service domains

Documents

MCP behavior

Read only

Yes

Does not modify remote state.

Destructive

May delete or overwrite remote data.

Idempotent

Yes

Safe to retry without extra side effects.

Open world

Yes

Can call out to external systems.

Get the content of a Notion page as markdown with the page's ID

Parameters

Parameter	Type	Req.	Description
`page_id`	`string`	Required	ID of the page to get content from

Requirements

No secrets required

Output

Type:string— The markdown content of the page

NotionToolkit.GetPageContentByTitle

Add to selected tools(no auth required)

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations

Read

Service domains

Documents

MCP behavior

Read only

Yes

Does not modify remote state.

Destructive

May delete or overwrite remote data.

Idempotent

Yes

Safe to retry without extra side effects.

Open world

Yes

Can call out to external systems.

Get the content of a Notion page as markdown with the page's title

Parameters

Parameter	Type	Req.	Description
`title`	`string`	Required	Title of the page to get content from

Requirements

No secrets required

Output

Type:string— The markdown content of the page

NotionToolkit.GetWorkspaceStructure

Add to selected tools(no auth required)

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations

Read

Service domains

Documents

MCP behavior

Read only

Yes

Does not modify remote state.

Destructive

May delete or overwrite remote data.

Idempotent

Yes

Safe to retry without extra side effects.

Open world

Yes

Can call out to external systems.

Get the workspace structure of the user's Notion workspace. Ideal for finding where an object is located in the workspace.

Parameters

No parameters required.

Requirements

No secrets required

Output

Type:json— The workspace structure

NotionToolkit.SearchByTitle

Add to selected tools(no auth required)

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations

Read

Service domains

Documents

MCP behavior

Read only

Yes

Does not modify remote state.

Destructive

May delete or overwrite remote data.

Idempotent

Yes

Safe to retry without extra side effects.

Open world

Yes

Can call out to external systems.

Search for similar titles of pages, databases, or both within the user's workspace. Does not include content.

Parameters

Parameter	Type	Req.	Description
`query`	`string`	Optional	A substring to search for within page and database titles. If not provided (default), all pages and/or databases are returned.
`select`	`string`	Optional	Limit the results to either only pages or only databases. Defaults to both. `pagedatabase`
`order_by`	`string`	Optional	The direction to sort search results by last edited time. Defaults to 'descending'. `ascendingdescending`
`limit`	`integer`	Optional	The maximum number of results to return. Defaults to 100. Set to -1 for no limit.

Requirements

No secrets required

Output

Type:json— A dictionary containing minimal information about the pages and/or databases that have titles that are the best match for the query. Does not include content or location.

NotionToolkit.WhoAmI

Add to selected tools(no auth required)

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations

Read

Service domains

Documents

MCP behavior

Read only

Yes

Does not modify remote state.

Destructive

May delete or overwrite remote data.

Idempotent

Yes

Safe to retry without extra side effects.

Open world

Yes

Can call out to external systems.

Get information about the current user and their Notion workspace. This tool provides detailed information about the authenticated user's Notion workspace including workspace statistics, user context, and integration details.

Parameters

No parameters required.

Requirements

No secrets required

Output

Type:json— Get comprehensive user profile and Notion workspace information.

Get Building

Use tools hosted on Arcade Cloud

Arcade tools are hosted by our cloud platform and ready to be used in your agents. Learn how.

Learn more

Self Host Arcade tools

Arcade tools can be self-hosted on your own infrastructure. Learn more about self-hosting.

pip install arcade_notiontoolkit

Learn more

Last updated on February 27, 2026

About Arcade