Monday.com MCP Server

Instructions

Implementation Reference

• src/mcp_server_monday/board.py:8-19 (handler)

  The handler function that fetches and returns the groups for a given Monday.com board ID using the Monday SDK.

  async def handle_monday_get_board_groups(
      boardId: str, monday_client: MondayClient
  ) -> list[types.TextContent]:
      """Get the Groups of a Monday.com Board."""
      response = monday_client.groups.get_groups_by_board(board_ids=boardId)
      return [
          types.TextContent(
              type="text",
              text=f"Got the groups of a Monday.com board. {json.dumps(response['data'])}",
          )
      ]

• src/mcp_server_monday/fastmcp_server.py:62-74 (registration)

  Registers the MCP tool 'monday_get_board_groups' with @mcp.tool(), handling input validation via type hints and delegating to the core handler.

  @mcp.tool()
  async def monday_get_board_groups(boardId: str) -> str:
      """Get the Groups of a Monday.com Board.
  
      Args:
          boardId: Monday.com Board ID that the Item or Sub-item is on.
      """
      try:
          client = get_monday_client()
          result = await handle_monday_get_board_groups(boardId, client)
          return result[0].text
      except Exception as e:
          return f"Error getting board groups: {e}"