Monday.com MCP Server

Instructions

Implementation Reference

• src/mcp_server_monday/item.py:167-177 (handler)

  Core implementation of the tool logic: calls monday_client.updates.create_update to add an update (comment) to the specified item.

  async def handle_monday_create_update_on_item(
      itemId: str,
      updateText: str,
      monday_client: MondayClient,
  ) -> list[types.TextContent]:
      monday_client.updates.create_update(item_id=itemId, update_value=updateText)
      return [
          types.TextContent(
              type="text", text=f"Created new update on Monday.com item: {updateText}"
          )
      ]

• src/mcp_server_monday/fastmcp_server.py:187-200 (registration)

  MCP tool registration for 'monday_create_update' (maps to 'monday-create-update'), includes input schema via type hints and docstring, wraps and calls the core handler.

  @mcp.tool()
  async def monday_create_update(itemId: str, updateText: str) -> str:
      """Create an update (comment) on a Monday.com Item or Sub-item.
  
      Args:
          itemId: Monday.com Item ID to create the update on.
          updateText: Content to update the Item or Sub-item with.
      """
      try:
          client = get_monday_client()
          result = await handle_monday_create_update_on_item(itemId, updateText, client)
          return result[0].text
      except Exception as e:
          return f"Error creating update: {e}"

• src/mcp_server_monday/fastmcp_server.py:189-194 (schema)

  Input schema documentation for the tool parameters.

  """Create an update (comment) on a Monday.com Item or Sub-item.
  
  Args:
      itemId: Monday.com Item ID to create the update on.
      updateText: Content to update the Item or Sub-item with.
  """