Agentic Service Discovery

Resources

N

Notion

by Notion Labs, Inc.

Read and write Notion pages and databases, query structured data, append content blocks, search the workspace, and manage comments.

ProductivityFree / PaidBearer tokennoteswikidatabasedocsknowledge-baseworkspace

How agents use Notion

  • Agent creates a new Notion page to log results, summaries, or reports after completing a task
  • Agent queries a Notion database to retrieve structured data like tasks, contacts, or inventory before making decisions
  • Agent appends content blocks to an existing page to build up meeting notes, research logs, or audit trails incrementally
  • Agent searches the workspace for relevant pages before creating a new one to avoid duplication
  • Agent creates a database row when a new lead, ticket, or event is detected in another system
  • Agent updates a database property (e.g. Status, Owner) when a workflow step completes
  • Agent adds a comment to a Notion page to notify team members or log what action was taken
  • Agent reads block children from a page to extract instructions, templates, or context for downstream processing

Agent actions

Create PageCreate a new Notion page inside a parent page or database, optionally with content blocks.

Inputs: parentId, parentType, title, properties, content

Returns: pageId, pageUrl, page

Retrieve PageFetch metadata and properties for a specific Notion page by ID.

Inputs: pageId

Returns: pageId, title, properties, pageUrl, lastEditedTime, page

Update PageUpdate properties, icon, cover, or archive status of an existing Notion page.

Inputs: pageId, properties, inTrash

Returns: pageId, page

Query DatabaseFilter and sort rows in a Notion database and return matching pages.

Inputs: databaseId, filter, sorts, pageSize, startCursor

Returns: results, hasMore, nextCursor, resultCount

Retrieve DatabaseFetch the schema and metadata of a Notion database.

Inputs: databaseId

Returns: databaseId, title, properties, database

Create DatabaseCreate a new Notion database as a child of an existing page.

Inputs: parentPageId, title, properties, isInline

Returns: databaseId, database

Update DatabaseUpdate the title, description, or schema of an existing Notion database.

Inputs: databaseId, title, description, properties

Returns: databaseId, database

Append Block ChildrenAppend one or more content blocks to the end of a Notion page or block.

Inputs: blockId, children

Returns: blocks, blockCount

Get Block ChildrenRetrieve the child blocks of a Notion page or block.

Inputs: blockId, pageSize, startCursor

Returns: blocks, hasMore, nextCursor

Retrieve BlockFetch a single Notion block by its ID.

Inputs: blockId

Returns: blockId, blockType, block

Update BlockUpdate the content or type of an existing Notion block.

Inputs: blockId, blockContent

Returns: block

Search WorkspaceSearch pages and databases in the Notion workspace by title.

Inputs: query, filterType, sortDirection, pageSize

Returns: results, resultCount, hasMore, nextCursor

Create CommentAdd a comment to a Notion page or an existing discussion thread.

Inputs: pageId, discussionId, text

Returns: commentId, comment

List CommentsRetrieve all comments on a Notion page or block.

Inputs: blockId, pageSize, startCursor

Returns: comments, commentCount, hasMore, nextCursor

List Workspace UsersRetrieve all users in the Notion workspace.

Inputs: pageSize, startCursor

Returns: users, userCount, hasMore

Retrieve UserFetch details for a specific Notion user by ID.

Inputs: userId

Returns: userId, name, email, user

Example workflows

1

Log agent results to a Notion database

After an agent run, create a new row in a Notion tracker database with the output, timestamp, and status.

2

Search and summarise Notion docs

Search the workspace for relevant pages, retrieve their block content, and pass it to an LLM node for summarisation.

3

Create structured meeting notes

After a meeting transcript is processed, create a new Notion page under a parent "Meetings" page with headings, action items, and attendee mentions.

About Notion

Vendor
Notion Labs, Inc.
Pricing Always review details with the vendor
Free / PaidAPI access requires Notion Plus (from ~€9.50/month) or higher. Free plan does not include API access.
Authentication
Bearer token
Rate limit Always review details with the vendor
180 requests / minute
Compatible nodes
AgentResourceOutput

Build an AI workflow with Notion

Use the Agentic Planner to design, visualize, and connect Notion with your other tools.

Open Agentic Planner

Related Productivity tools