Monday.com MCP Server

Instructions

Implementation Reference

• src/mcp_server_monday/item.py:277-294 (handler)

  The handler function that executes the tool logic by calling monday_client.items.move_item_to_group to move the item to the specified group.

  async def handle_monday_move_item_to_group(
      monday_client: MondayClient, item_id: str, group_id: str
  ) -> list[types.TextContent]:
      """
      Move an item to a group in a Monday.com board.
  
      Args:
          monday_client (MondayClient): The Monday.com client.
          item_id (str): The ID of the item to move.
          group_id (str): The ID of the group to move the item to.
      """
      item = monday_client.items.move_item_to_group(item_id=item_id, group_id=group_id)
      return [
          types.TextContent(
              type="text",
              text=f"Moved item {item_id} to group {group_id}. ID of the moved item: {item['data']['move_item_to_group']['id']}",
          )
      ]

• src/mcp_server_monday/fastmcp_server.py:240-254 (registration)

  Registers the monday_move_item_to_group tool using @mcp.tool decorator, which wraps the core handler and handles client initialization and error wrapping.

  @mcp.tool()
  async def monday_move_item_to_group(itemId: str, groupId: str) -> str:
      """Move an item to a group in a Monday.com board.
  
      Args:
          itemId: Monday.com Item ID to move.
          groupId: Monday.com Group ID to move the Item to.
      """
      try:
          client = get_monday_client()
          result = await handle_monday_move_item_to_group(client, itemId, groupId)
          return result[0].text
      except Exception as e:
          return f"Error moving item: {e}"