Monday.com MCP Server

Instructions

Implementation Reference

• src/mcp_server_monday/item.py:311-323 (handler)

  The handler function that performs the archiving by calling monday_client.items.archive_item_by_id and returns a success message.

  async def handle_monday_archive_item(
      monday_client: MondayClient, item_id: str
  ) -> list[types.TextContent]:
      """
      Archive an item from a Monday.com board.
  
      Args:
          monday_client (MondayClient): The Monday.com client.
          item_id (str): The ID of the item to archive.
      """
      monday_client.items.archive_item_by_id(item_id=item_id)
      return [types.TextContent(type="text", text=f"Archived item {item_id}.")]

• src/mcp_server_monday/fastmcp_server.py:272-283 (registration)

  The tool registration using @mcp.tool() for 'monday_archive_item', which wraps the handler with error handling and client initialization.

  async def monday_archive_item(itemId: str) -> str:
      """Archive an item from a Monday.com board.
  
      Args:
          itemId: Monday.com Item ID to archive.
      """
      try:
          client = get_monday_client()
          result = await handle_monday_archive_item(client, itemId)
          return result[0].text
      except Exception as e:
          return f"Error archiving item: {e}"