Notion

21 actions for managing pages, databases, blocks, comments, and search.

Pages

`create_page`

Parameter	Type	Required	Description
`parent`	object	yes	`{ database_id: "..." }` or `{ page_id: "..." }` or `{ workspace: true }`
`properties`	object	yes	Page properties (title, etc.)
`children`	array	no	Block content to add

exec("notion.create_page", {
  parent: { database_id: "abc123" },
  properties: {
    title: [{ text: { content: "New Spec Document" } }]
  }
})

`update_page`

Parameter	Type	Required
`pageId`	string	yes
`properties`	object	yes

`get_page`

Parameter	Type	Required
`pageId`	string	yes

`archive_page`

Soft-delete a page.

Parameter	Type	Required
`pageId`	string	yes

`get_page_property`

Parameter	Type	Required
`pageId`	string	yes
`propertyId`	string	yes

`get_page_markdown`

Get page content as markdown. Useful for reading full documents.

Parameter	Type	Required
`pageId`	string	yes

`update_page_markdown`

Replace page body from markdown.

Parameter	Type	Required
`pageId`	string	yes
`markdown`	string	yes

Databases

`query_database`

Query a database with filters and sorts.

Parameter	Type	Required	Description
`databaseId`	string	yes	Database to query
`filter`	object	no	Notion filter object
`sorts`	array	no	Sort instructions

exec("notion.query_database", {
  databaseId: "db123",
  filter: {
    property: "Status",
    select: { equals: "In Progress" }
  },
  sorts: [{ property: "Priority", direction: "descending" }]
})

`get_database`

Get database schema (properties, title, description).

Parameter	Type	Required
`databaseId`	string	yes

`create_database`

Parameter	Type	Required	Description
`parent`	object	yes	`{ page_id: "..." }`
`properties`	object	yes	Database schema
`title`	string	no	Database title

`update_database`

Parameter	Type	Required
`databaseId`	string	yes
`title`	string	no
`description`	string	no
`properties`	object	no

Blocks

`get_block`

Parameter	Type	Required
`blockId`	string	yes

`update_block`

Parameter	Type	Required
`blockId`	string	yes
`content`	object	yes

`delete_block`

Parameter	Type	Required
`blockId`	string	yes

`append_blocks`

Add content blocks to a page or existing block.

Parameter	Type	Required
`blockId`	string	yes
`children`	array	yes

`get_block_children`

Get all content blocks of a page or block.

Parameter	Type	Required
`blockId`	string	yes

Comments

`create_comment`

Parameter	Type	Required	Description
`rich_text`	array	yes	Comment content
`parent`	object	no	`{ page_id: "..." }` for page comments
`discussion_id`	string	no	Reply to existing discussion thread

`list_comments`

Parameter	Type	Required
`blockId`	string	yes

Search & Users

`search`

Search across all pages and databases.

Parameter	Type	Required	Description
`query`	string	yes	Search text
`page_size`	number	no	Results per page (default 10)

`list_users`

No parameters. Returns all workspace users.

`get_user`

Parameter	Type	Required
`userId`	string	yes