Monday.com MCP Server

Instructions

Implementation Reference

• src/mcp_server_monday/item.py:151-164 (handler)

  Core handler function executing the tool logic by calling Monday.com API to update item column values.

  async def handle_monday_update_item(
      boardId: str,
      itemId: str,
      columnValues: dict[str],
      monday_client: MondayClient,
  ):
      response = monday_client.items.change_multiple_column_values(
          board_id=boardId, item_id=itemId, column_values=columnValues
      )
      return [
          types.TextContent(
              type="text", text=f"Updated Monday.com item. {json.dumps(response)}"
          )
      ]

• src/mcp_server_monday/fastmcp_server.py:168-184 (registration)

  Registers the 'monday_update_item' tool with FastMCP (@mcp.tool()), defines input schema via parameters, and delegates to the handler.

  @mcp.tool()
  async def monday_update_item(
      boardId: str, itemId: str, columnValues: Dict[str, Any]
  ) -> str:
      """Update a Monday.com item's or sub-item's column values.
  
      Args:
          boardId: Monday.com Board ID that the Item or Sub-item is on.
          itemId: Monday.com Item or Sub-item ID to update the columns of.
          columnValues: Dictionary of column values to update the Monday.com Item or Sub-item with. ({column_id: value}).
      """
      try:
          client = get_monday_client()
          result = await handle_monday_update_item(boardId, itemId, columnValues, client)
          return result[0].text
      except Exception as e:
          return f"Error updating item: {e}"

• src/mcp_server_monday/fastmcp_server.py:169-184 (schema)

  Input schema defined by function parameters and docstring describing boardId (str), itemId (str), columnValues (Dict[str, Any]). Output is str.

  async def monday_update_item(
      boardId: str, itemId: str, columnValues: Dict[str, Any]
  ) -> str:
      """Update a Monday.com item's or sub-item's column values.
  
      Args:
          boardId: Monday.com Board ID that the Item or Sub-item is on.
          itemId: Monday.com Item or Sub-item ID to update the columns of.
          columnValues: Dictionary of column values to update the Monday.com Item or Sub-item with. ({column_id: value}).
      """
      try:
          client = get_monday_client()
          result = await handle_monday_update_item(boardId, itemId, columnValues, client)
          return result[0].text
      except Exception as e:
          return f"Error updating item: {e}"