AptlyStar

Monday

Manage Monday.com boards, items, and groups

使用说明

Integrate with Monday.com to list boards, get board details, fetch and search items, create and update items, archive or delete items, create subitems, move items between groups, add updates, and create groups.

工具

monday_list_boards

List boards from your Monday.com account

输入

参数类型必填描述
limitnumber否Maximum number of boards to return (default 25, max 500)
pagenumber否Page number for pagination (starts at 1)

输出

参数类型描述
boardsarrayList of Monday.com boards
↳ idstringBoard ID
↳ namestringBoard name
↳ descriptionstringBoard description
↳ statestringBoard state (active, archived, deleted)
↳ boardKindstringBoard kind (public, private, share)
↳ itemsCountnumberNumber of items on the board
↳ urlstringBoard URL
↳ updatedAtstringLast updated timestamp
countnumberNumber of boards returned

monday_get_board

Get a specific Monday.com board with its groups and columns

输入

参数类型必填描述
boardIdstring是The ID of the board to retrieve

输出

参数类型描述
boardjsonBoard details
↳ idstringBoard ID
↳ namestringBoard name
↳ descriptionstringBoard description
↳ statestringBoard state
↳ boardKindstringBoard kind (public, private, share)
↳ itemsCountnumberNumber of items
↳ urlstringBoard URL
↳ updatedAtstringLast updated timestamp
groupsarrayGroups on the board
↳ idstringGroup ID
↳ titlestringGroup title
↳ colorstringGroup color (hex)
↳ archivedbooleanWhether the group is archived
↳ deletedbooleanWhether the group is deleted
↳ positionstringGroup position
columnsarrayColumns on the board
↳ idstringColumn ID
↳ titlestringColumn title
↳ typestringColumn type

monday_get_item

Get a specific item by ID from Monday.com

输入

参数类型必填描述
itemIdstring是The ID of the item to retrieve

输出

参数类型描述
itemjsonThe requested item
↳ idstringItem ID
↳ namestringItem name
↳ statestringItem state
↳ boardIdstringBoard ID
↳ groupIdstringGroup ID
↳ groupTitlestringGroup title
↳ columnValuesarrayColumn values
↳ idstringColumn ID
↳ textstringText value
↳ valuestringRaw JSON value
↳ typestringColumn type
↳ createdAtstringCreation timestamp
↳ updatedAtstringLast updated timestamp
↳ urlstringItem URL

monday_get_items

Get items from a Monday.com board

输入

参数类型必填描述
boardIdstring是The ID of the board to get items from
groupIdstring否Filter items by group ID
limitnumber否Maximum number of items to return (default 25, max 500)

输出

参数类型描述
itemsarrayList of items from the board
↳ idstringItem ID
↳ namestringItem name
↳ statestringItem state (active, archived, deleted)
↳ boardIdstringBoard ID
↳ groupIdstringGroup ID
↳ groupTitlestringGroup title
↳ columnValuesarrayColumn values for the item
↳ idstringColumn ID
↳ textstringHuman-readable text value
↳ valuestringRaw JSON value
↳ typestringColumn type
↳ createdAtstringCreation timestamp
↳ updatedAtstringLast updated timestamp
↳ urlstringItem URL
countnumberNumber of items returned

monday_search_items

Search for items on a Monday.com board by column values

输入

参数类型必填描述
boardIdstring是The ID of the board to search
columnsstring是JSON array of column filters, e.g. [{"column_id":"status","column_values":["Done"]}]
limitnumber否Maximum number of items to return (default 25, max 500)
cursorstring否Pagination cursor from a previous search response

输出

参数类型描述
itemsarrayMatching items
↳ idstringItem ID
↳ namestringItem name
↳ statestringItem state
↳ boardIdstringBoard ID
↳ groupIdstringGroup ID
↳ groupTitlestringGroup title
↳ columnValuesarrayColumn values
↳ idstringColumn ID
↳ textstringText value
↳ valuestringRaw JSON value
↳ typestringColumn type
↳ createdAtstringCreation timestamp
↳ updatedAtstringLast updated timestamp
↳ urlstringItem URL
countnumberNumber of items returned
cursorstringPagination cursor for fetching the next page

monday_create_item

Create a new item on a Monday.com board

输入

参数类型必填描述
boardIdstring是The ID of the board to create the item on
itemNamestring是The name of the new item
groupIdstring否The group ID to create the item in
columnValuesstring否JSON string of column values to set (e.g., {"status":"Done","date":"2024-01-01"})

输出

参数类型描述
itemjsonThe created item
↳ idstringItem ID
↳ namestringItem name
↳ statestringItem state
↳ boardIdstringBoard ID
↳ groupIdstringGroup ID
↳ groupTitlestringGroup title
↳ columnValuesarrayColumn values
↳ idstringColumn ID
↳ textstringText value
↳ valuestringRaw JSON value
↳ typestringColumn type
↳ createdAtstringCreation timestamp
↳ updatedAtstringLast updated timestamp
↳ urlstringItem URL

monday_update_item

Update column values of an item on a Monday.com board

输入

参数类型必填描述
boardIdstring是The ID of the board containing the item
itemIdstring是The ID of the item to update
columnValuesstring是JSON string of column values to update (e.g., {"status":"Done","date":"2024-01-01"})

输出

参数类型描述
itemjsonThe updated item
↳ idstringItem ID
↳ namestringItem name
↳ statestringItem state
↳ boardIdstringBoard ID
↳ groupIdstringGroup ID
↳ groupTitlestringGroup title
↳ columnValuesarrayColumn values
↳ idstringColumn ID
↳ textstringText value
↳ valuestringRaw JSON value
↳ typestringColumn type
↳ createdAtstringCreation timestamp
↳ updatedAtstringLast updated timestamp
↳ urlstringItem URL

monday_delete_item

Delete an item from a Monday.com board

输入

参数类型必填描述
itemIdstring是The ID of the item to delete

输出

参数类型描述
idstringThe ID of the deleted item

monday_archive_item

Archive an item on a Monday.com board

输入

参数类型必填描述
itemIdstring是The ID of the item to archive

输出

参数类型描述
idstringThe ID of the archived item

monday_move_item_to_group

Move an item to a different group on a Monday.com board

输入

参数类型必填描述
itemIdstring是The ID of the item to move
groupIdstring是The ID of the target group

输出

参数类型描述
itemjsonThe moved item with updated group
↳ idstringItem ID
↳ namestringItem name
↳ statestringItem state
↳ boardIdstringBoard ID
↳ groupIdstringGroup ID
↳ groupTitlestringGroup title
↳ columnValuesarrayColumn values
↳ idstringColumn ID
↳ textstringText value
↳ valuestringRaw JSON value
↳ typestringColumn type
↳ createdAtstringCreation timestamp
↳ updatedAtstringLast updated timestamp
↳ urlstringItem URL

monday_create_subitem

Create a subitem under a parent item on Monday.com

输入

参数类型必填描述
parentItemIdstring是The ID of the parent item
itemNamestring是The name of the new subitem
columnValuesstring否JSON string of column values to set

输出

参数类型描述
itemjsonThe created subitem
↳ idstringItem ID
↳ namestringItem name
↳ statestringItem state
↳ boardIdstringBoard ID
↳ groupIdstringGroup ID
↳ groupTitlestringGroup title
↳ columnValuesarrayColumn values
↳ idstringColumn ID
↳ textstringText value
↳ valuestringRaw JSON value
↳ typestringColumn type
↳ createdAtstringCreation timestamp
↳ updatedAtstringLast updated timestamp
↳ urlstringItem URL

monday_create_update

Add an update (comment) to a Monday.com item

输入

参数类型必填描述
itemIdstring是The ID of the item to add the update to
bodystring是The update text content (supports HTML)

输出

参数类型描述
updatejsonThe created update
↳ idstringUpdate ID
↳ bodystringUpdate body (HTML)
↳ textBodystringPlain text body
↳ createdAtstringCreation timestamp
↳ creatorIdstringCreator user ID
↳ itemIdstringItem ID

monday_create_group

Create a new group on a Monday.com board

输入

参数类型必填描述
boardIdstring是The ID of the board to create the group on
groupNamestring是The name of the new group (max 255 characters)
groupColorstring否The group color as a hex code (e.g., "#ff642e")

输出

参数类型描述
groupjsonThe created group
↳ idstringGroup ID
↳ titlestringGroup title
↳ colorstringGroup color (hex)
↳ archivedbooleanWhether archived
↳ deletedbooleanWhether deleted
↳ positionstringGroup position

On this page