Skip to content

feat(integrations): extend Telegram, Outlook, and Notion tool depth #5265

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
waleedlatif1 merged 13 commits into from
Jun 29, 2026
+5,320 −80
Merged

feat(integrations): extend Telegram, Outlook, and Notion tool depth #5265

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
13 commits
Select commit Hold shift + click to select a range
d2a9373
feat(telegram): add edit, forward, copy, location, contact, poll, pin…
waleedlatif1 Jun 29, 2026
3be1cf9
feat(outlook): add reply, reply-all, folders, attachments, search, an…
waleedlatif1 Jun 29, 2026
af1aac9
feat(notion): add block children CRUD, comments, and users tools (v1 …
waleedlatif1 Jun 29, 2026
9b508bd
docs(integrations): regenerate docs + catalog for telegram, outlook, …
waleedlatif1 Jun 29, 2026
fa5a2c4
fix(notion): guard pageSize coercion with Number.isFinite so non-nume…
waleedlatif1 Jun 29, 2026
8bc7add
fix(telegram): normalize send_poll options (array, JSON string, or ne…
waleedlatif1 Jun 29, 2026
3f16505
fix(integrations): harden outlook search quoting, notion archive defa…
waleedlatif1 Jun 29, 2026
8c84970
fix(integrations): normalize outlook categories input and clamp notio…
waleedlatif1 Jun 29, 2026
1aaa094
fix(outlook): pass raw categories to the tool's normalizeCategories s…
waleedlatif1 Jun 29, 2026
65ddd74
fix(outlook): allow clearing message categories by passing an empty a…
waleedlatif1 Jun 29, 2026
786c646
fix(outlook): only clear categories on an explicit empty array, not a…
waleedlatif1 Jun 29, 2026
19d0208
fix(notion): clamp page_size to 1-100 at the tool layer for list comm…
waleedlatif1 Jun 29, 2026
628f5cd
fix(outlook): use consistent set/replace semantics for message catego…
waleedlatif1 Jun 29, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
283 changes: 283 additions & 0 deletions apps/docs/content/docs/en/integrations/notion.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -273,6 +273,289 @@ Create a new database in Notion with custom properties
| `last_edited_time` | string | ISO 8601 last edit timestamp |
| `title` | string | Row title |

### `notion_append_blocks`

Append new block children (content) to a Notion page or block

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `blockId` | string | Yes | The UUID of the page or block to append children to |
| `children` | json | Yes | Array of Notion block objects to append \(max 100\) |
| `after` | string | No | UUID of an existing block to append the new children after |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `content` | string | Page content in markdown format, or comment text for create comment |
| `title` | string | Page or database title |
| `url` | string | Notion URL |
| `id` | string | Page, database, block, comment, or user ID |
| `created_time` | string | Creation timestamp |
| `last_edited_time` | string | Last edit timestamp |
| `results` | array | Array of results \(pages, blocks, comments, or users\) |
| `has_more` | boolean | Whether more results are available |
| `next_cursor` | string | Cursor for pagination |
| `total_results` | number | Number of results returned |
| `properties` | json | Database properties schema |
| `appended` | boolean | Whether content was successfully appended |
| `type` | string | Block type |
| `block` | json | The full updated Notion block object |
| `archived` | boolean | Whether the block was archived |
| `discussion_id` | string | Discussion thread ID |
| `name` | string | User display name |
| `avatar_url` | string | User avatar image URL |
| `email` | string | User email address \(person users only\) |

### `notion_retrieve_block_children`

Retrieve the block children (content) of a Notion page or block

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `blockId` | string | Yes | The UUID of the page or block whose children to retrieve |
| `startCursor` | string | No | Pagination cursor returned by a previous request |
| `pageSize` | number | No | Number of results to return \(1-100, default 100\) |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `content` | string | Page content in markdown format, or comment text for create comment |
| `title` | string | Page or database title |
| `url` | string | Notion URL |
| `id` | string | Page, database, block, comment, or user ID |
| `created_time` | string | Creation timestamp |
| `last_edited_time` | string | Last edit timestamp |
| `results` | array | Array of results \(pages, blocks, comments, or users\) |
| `has_more` | boolean | Whether more results are available |
| `next_cursor` | string | Cursor for pagination |
| `total_results` | number | Number of results returned |
| `properties` | json | Database properties schema |
| `appended` | boolean | Whether content was successfully appended |
| `type` | string | Block type |
| `block` | json | The full updated Notion block object |
| `archived` | boolean | Whether the block was archived |
| `discussion_id` | string | Discussion thread ID |
| `name` | string | User display name |
| `avatar_url` | string | User avatar image URL |
| `email` | string | User email address \(person users only\) |

### `notion_update_block`

Update the content or archived state of a single Notion block

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `blockId` | string | Yes | The UUID of the block to update |
| `block` | json | Yes | Block-type object with the fields to update, e.g. \{"paragraph": \{"rich_text": \[...\]\}\} |
| `archived` | boolean | No | Set to true to archive \(delete\) the block, or false to restore it |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `content` | string | Page content in markdown format, or comment text for create comment |
| `title` | string | Page or database title |
| `url` | string | Notion URL |
| `id` | string | Page, database, block, comment, or user ID |
| `created_time` | string | Creation timestamp |
| `last_edited_time` | string | Last edit timestamp |
| `results` | array | Array of results \(pages, blocks, comments, or users\) |
| `has_more` | boolean | Whether more results are available |
| `next_cursor` | string | Cursor for pagination |
| `total_results` | number | Number of results returned |
| `properties` | json | Database properties schema |
| `appended` | boolean | Whether content was successfully appended |
| `type` | string | Block type |
| `block` | json | The full updated Notion block object |
| `archived` | boolean | Whether the block was archived |
| `discussion_id` | string | Discussion thread ID |
| `name` | string | User display name |
| `avatar_url` | string | User avatar image URL |
| `email` | string | User email address \(person users only\) |

### `notion_delete_block`

Delete (move to trash) a single Notion block

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `blockId` | string | Yes | The UUID of the block to delete |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `content` | string | Page content in markdown format, or comment text for create comment |
| `title` | string | Page or database title |
| `url` | string | Notion URL |
| `id` | string | Page, database, block, comment, or user ID |
| `created_time` | string | Creation timestamp |
| `last_edited_time` | string | Last edit timestamp |
| `results` | array | Array of results \(pages, blocks, comments, or users\) |
| `has_more` | boolean | Whether more results are available |
| `next_cursor` | string | Cursor for pagination |
| `total_results` | number | Number of results returned |
| `properties` | json | Database properties schema |
| `appended` | boolean | Whether content was successfully appended |
| `type` | string | Block type |
| `block` | json | The full updated Notion block object |
| `archived` | boolean | Whether the block was archived |
| `discussion_id` | string | Discussion thread ID |
| `name` | string | User display name |
| `avatar_url` | string | User avatar image URL |
| `email` | string | User email address \(person users only\) |

### `notion_create_comment`

Create a comment on a Notion page or within an existing discussion thread

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `pageId` | string | No | UUID of the page to comment on \(provide either pageId or discussionId\) |
| `discussionId` | string | No | UUID of an existing discussion thread to reply to |
| `content` | string | Yes | The text content of the comment |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `content` | string | Page content in markdown format, or comment text for create comment |
| `title` | string | Page or database title |
| `url` | string | Notion URL |
| `id` | string | Page, database, block, comment, or user ID |
| `created_time` | string | Creation timestamp |
| `last_edited_time` | string | Last edit timestamp |
| `results` | array | Array of results \(pages, blocks, comments, or users\) |
| `has_more` | boolean | Whether more results are available |
| `next_cursor` | string | Cursor for pagination |
| `total_results` | number | Number of results returned |
| `properties` | json | Database properties schema |
| `appended` | boolean | Whether content was successfully appended |
| `type` | string | Block type |
| `block` | json | The full updated Notion block object |
| `archived` | boolean | Whether the block was archived |
| `discussion_id` | string | Discussion thread ID |
| `name` | string | User display name |
| `avatar_url` | string | User avatar image URL |
| `email` | string | User email address \(person users only\) |

### `notion_list_comments`

List unresolved comments on a Notion page or block

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `blockId` | string | Yes | The UUID of the page or block whose comments to list |
| `startCursor` | string | No | Pagination cursor returned by a previous request |
| `pageSize` | number | No | Number of results to return \(1-100, default 100\) |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `content` | string | Page content in markdown format, or comment text for create comment |
| `title` | string | Page or database title |
| `url` | string | Notion URL |
| `id` | string | Page, database, block, comment, or user ID |
| `created_time` | string | Creation timestamp |
| `last_edited_time` | string | Last edit timestamp |
| `results` | array | Array of results \(pages, blocks, comments, or users\) |
| `has_more` | boolean | Whether more results are available |
| `next_cursor` | string | Cursor for pagination |
| `total_results` | number | Number of results returned |
| `properties` | json | Database properties schema |
| `appended` | boolean | Whether content was successfully appended |
| `type` | string | Block type |
| `block` | json | The full updated Notion block object |
| `archived` | boolean | Whether the block was archived |
| `discussion_id` | string | Discussion thread ID |
| `name` | string | User display name |
| `avatar_url` | string | User avatar image URL |
| `email` | string | User email address \(person users only\) |

### `notion_list_users`

List all users (members and bots) in the Notion workspace

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `startCursor` | string | No | Pagination cursor returned by a previous request |
| `pageSize` | number | No | Number of results to return \(1-100, default 100\) |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `content` | string | Page content in markdown format, or comment text for create comment |
| `title` | string | Page or database title |
| `url` | string | Notion URL |
| `id` | string | Page, database, block, comment, or user ID |
| `created_time` | string | Creation timestamp |
| `last_edited_time` | string | Last edit timestamp |
| `results` | array | Array of results \(pages, blocks, comments, or users\) |
| `has_more` | boolean | Whether more results are available |
| `next_cursor` | string | Cursor for pagination |
| `total_results` | number | Number of results returned |
| `properties` | json | Database properties schema |
| `appended` | boolean | Whether content was successfully appended |
| `type` | string | Block type |
| `block` | json | The full updated Notion block object |
| `archived` | boolean | Whether the block was archived |
| `discussion_id` | string | Discussion thread ID |
| `name` | string | User display name |
| `avatar_url` | string | User avatar image URL |
| `email` | string | User email address \(person users only\) |

### `notion_retrieve_user`

Retrieve a single Notion user by their UUID

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `userId` | string | Yes | The UUID of the user to retrieve |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `content` | string | Page content in markdown format, or comment text for create comment |
| `title` | string | Page or database title |
| `url` | string | Notion URL |
| `id` | string | Page, database, block, comment, or user ID |
| `created_time` | string | Creation timestamp |
| `last_edited_time` | string | Last edit timestamp |
| `results` | array | Array of results \(pages, blocks, comments, or users\) |
| `has_more` | boolean | Whether more results are available |
| `next_cursor` | string | Cursor for pagination |
| `total_results` | number | Number of results returned |
| `properties` | json | Database properties schema |
| `appended` | boolean | Whether content was successfully appended |
| `type` | string | Block type |
| `block` | json | The full updated Notion block object |
| `archived` | boolean | Whether the block was archived |
| `discussion_id` | string | Discussion thread ID |
| `name` | string | User display name |
| `avatar_url` | string | User avatar image URL |
| `email` | string | User email address \(person users only\) |



## Triggers
Expand Down
Loading
Loading