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

Notion AI Agent Integration | Fugentic