Monday.com MCP Server

Instructions

Implementation Reference

• src/mcp_server_monday/fastmcp_server.py:287-300 (handler)

  The FastMCP tool handler decorated with @mcp.tool() for the 'monday_get_item_updates' tool. It retrieves the Monday client, calls the core helper function, and returns the formatted text result or error.

  async def monday_get_item_updates(itemId: str, limit: int = 25) -> str:
      """Get updates for a specific item in Monday.com.
  
      Args:
          itemId: ID of the Monday.com item to get updates for.
          limit: Maximum number of updates to retrieve. Default is 25.
      """
      try:
          client = get_monday_client()
          result = await handle_monday_get_item_updates(itemId, limit, client)
          return result[0].text
      except Exception as e:
          return f"Error getting item updates: {e}"

• src/mcp_server_monday/item.py:203-274 (helper)

  The core implementation function 'handle_monday_get_item_updates' that executes a GraphQL query to fetch the latest updates for a Monday.com item, formats the response with details like creator, body, and assets, and returns TextContent.

  async def handle_monday_get_item_updates(
      itemId: str,
      monday_client: MondayClient,
      limit: int = 25,
  ) -> list[types.TextContent]:
      """Get updates for a specific item in Monday.com"""
  
      query = f"""
      query {{
          items (ids: {itemId}) {{
              updates (limit: {limit}) {{
                  id
                  body
                  created_at
                  creator {{
                      id
                      name
                  }}
                  assets {{
                      id
                      name
                      url
                  }}
              }}
          }}
      }}
      """
  
      # Setting no_log flag to true if it exists to prevent activity tracking
      # Note: This is a preventative measure as the _query method might accept this parameter
      try:
          response = monday_client.custom._query(query, no_log=True)
      except TypeError:
          # If no_log param doesn't exist, try with default params
          response = monday_client.custom._query(query)
  
      if (
          not response
          or "data" not in response
          or not response["data"]["items"]
          or not response["data"]["items"][0]["updates"]
      ):
          return [
              types.TextContent(type="text", text=f"No updates found for item {itemId}.")
          ]
  
      updates = response["data"]["items"][0]["updates"]
  
      formatted_updates = []
      for update in updates:
          update_text = f"Update ID: {update['id']}\n"
          update_text += f"Created: {update['created_at']}\n"
          update_text += (
              f"Creator: {update['creator']['name']} (ID: {update['creator']['id']})\n"
          )
          update_text += f"Body: {update['body']}\n"
  
          # Add information about attached files if present
          if update.get("assets"):
              update_text += "\nAttached Files:\n"
              for asset in update["assets"]:
                  update_text += f"- {asset['name']}: {asset['url']}\n"
  
          update_text += "\n\n"
          formatted_updates.append(update_text)
  
      return [
          types.TextContent(
              type="text",
              text=f"Updates for item {itemId}:\n\n{''.join(formatted_updates)}",
          )
      ]

• src/mcp_server_monday/fastmcp_server.py:11-30 (registration)

  Imports from mcp_server_monday.item including the handle_monday_get_item_updates function used by the tool handler.

  from mcp_server_monday.board import (
      handle_monday_create_board,
      handle_monday_create_new_board_group,
      handle_monday_get_board_columns,
      handle_monday_get_board_groups,
      handle_monday_list_boards,
  )
  from mcp_server_monday.constants import MONDAY_API_KEY
  from mcp_server_monday.item import (
      handle_monday_archive_item,
      handle_monday_create_item,
      handle_monday_create_update_on_item,
      handle_monday_delete_item,
      handle_monday_get_item_by_id,
      handle_monday_get_item_updates,
      handle_monday_list_items_in_groups,
      handle_monday_list_subitems_in_items,
      handle_monday_move_item_to_group,
      handle_monday_update_item,
  )