Notion

Arcade's Notion toolkit connects LLMs to the Notion API, enabling agents to read, write, and navigate pages, databases, and workspace structure on behalf of authenticated users.

Capabilities

Content access & editing: Retrieve page content as Markdown by ID or title, append Markdown to the end of existing pages, and create new pages under a named parent.
Metadata & search: Look up object metadata (ID, timestamps, properties, URL) by title or ID, and search the workspace for pages or databases by title.
Workspace navigation: Inspect up to 100 recently edited objects as a tree, list direct child pages and databases of any node (with cursor-based pagination), and resolve the full breadcrumb path for any page or database.
Identity: Retrieve the authenticated user's profile, workspace statistics, and integration context.

OAuth

This toolkit uses OAuth 2.0 via the Notion provider. Arcade handles the authorization flow and token lifecycle automatically. See the Notion auth provider docs for configuration details.

	Tool name	Description	Secrets
	Notion.AppendContentToEndOfPage	Append markdown content to the end of a Notion page by its ID or title
	Notion.CreatePage	Create a new Notion page by the title of the new page's parent.
	Notion.GetObjectLocation	Find the breadcrumb path for one page or database. A `complete` path starts at a workspace root. An incomplete path is still the real prefix of the object's location: `stop_reason` says what ended the walk, and for a rate limit `retry_after_seconds` carries Notion's own backoff.
	Notion.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. Prefer `object_id` for exact lookup; use `object_title` (with optional `object_type`) when only a name is known. The title is case-insensitive and outer whitespace is ignored. Returns all exact title matches in a bounded search window, or a one-item list by ID. Object metadata includes its ID, timestamps, properties, URL, and more.
	Notion.GetPageContentById	Get the content of a Notion page as markdown with the page's ID
	Notion.GetPageContentByTitle	Get the content of a Notion page as markdown with the page's title
	Notion.GetWorkspaceStructure	Get up to 100 recently edited pages and databases as a tree. The 100 counts pages and databases only: database rows are skipped (they are not sidebar structure) and reported as omitted_database_rows. This is a recency-limited sample, not a complete listing: a specific object you are looking for may not appear here at all — search for it by name and get its location instead. A truncated response means more workspace objects exist. When sampled_objects is 0 while omitted_database_rows is high, the workspace is busy with database row edits rather than empty — search by title instead of concluding the workspace has no content. Unplaced objects are not transitively reachable from a workspace root in this sample — for example block-nested objects, objects whose parent was omitted from the sample, or descendants of those. They are not attached under a possibly incorrect workspace root. Navigate an unplaced object by passing its own `id` (not `parent_id` or `containing_block_id`) to GetObjectLocation or ListChildObjects.
	Notion.ListChildObjects	List direct child pages and databases without counting an entire subtree. Page children of the requested object come first, then children nested inside its containers (toggles, columns, callouts). Continue by passing `next_cursor` back; when `next_cursor` is null there is nothing further to fetch. `truncated` means the walk stopped before enumerating everything, with `stop_reason` saying why. If `next_cursor` is also set, continue from it. If `next_cursor` is null, more windows cannot recover what was missed — every call re-walks the same bounded budget — so do not keep paging: call this tool again on a narrower parent (a specific child page), or use GetObjectLocation for one object you already know about. For a rate limit, wait `retry_after_seconds` before retrying.
	Notion.SearchByTitle	Search for similar titles of pages, databases, or both within the user's workspace. Does not include content.
	Notion.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.

Capabilities

OAuth

Available tools(10)

Get Building